home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 23.zip / BS1 part 23 / A64 package v1.00 68000.adf / Manual < prev    next >
Text File  |  1991-06-30  |  141KB  |  4,374 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                                The A64 Package
  27.  
  28.                         Copyright (C) 1990, QuesTronix
  29.  
  30.                      Designed and Written By: Cliff Dugan
  31.  
  32.  
  33.  
  34.                                   QuesTronix
  35.                                 P.O. Box 340285
  36.                             Hartford, CT 06134-0285
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                                                       8/90 1.00
  65.  
  66. -
  67.  
  68.  
  69.  
  70. COPYRIGHT
  71.  
  72.     The A64 Package, Copyright (C) 1990, QuesTronix.
  73.  
  74.     All programs in The A64 Package including, but not limited to: A64, 64Cmd,
  75.     64Dir, 64Print, 64Status, 64ToAmiga, AmigaTo64, Pet2ASCII and StripLoadAddr
  76.     are Copyright (C) 1990, QuesTronix.
  77.  
  78.     All documentation in The A64 Package including this manual are Copyright
  79.     (C) 1990, QuesTronix.
  80.  
  81.  
  82. DISCLAIMER
  83.  
  84.     The A64 Package is provided "as is" without warranty of any kind, either
  85.     expressed or implied, including, but not limited to, the implied warranties
  86.     of merchantability and fitness for a particular purpose.  In no event will
  87.     QuesTronix be liable for incidental, consequential or other similar
  88.     damages.  The entire risk as to the quality and performance of The A64
  89.     Package is with you.
  90.  
  91.     QuesTronix reserves the right to change The A64 Packages' Copyright status
  92.     and/or cost at any time, without notice.
  93.  
  94.  
  95. CREDITS
  96.  
  97.     The A64 Package was designed and written by Cliff Dugan.
  98.  
  99.  
  100.  
  101.  
  102.                                                                           1
  103.  
  104.  
  105.  
  106. -
  107.  
  108.  
  109.  
  110. SYSTEM REQUIREMENTS
  111.  
  112.     All programs in The A64 Package will work with V1.2 or higher WorkBench.
  113.  
  114.     The utility programs included with The A64 Package will run with 512k RAM.
  115.  
  116.     A64 will run "as is" with 1mb RAM, but can be made to run with 512k RAM
  117.     (See A64 AND MEMORY in the TECHNICAL section).
  118.  
  119.     All programs included with The A64 Package will work with the 68000
  120.     microprocessor only (See 680x0 SUPPORT in the TECHNICAL section).
  121.  
  122.     If the hardware interface is used, a separate adapter cable is required for
  123.     the Amiga 1000.
  124.  
  125.  
  126.  
  127. REPLACEMENTS
  128.  
  129.     QuesTronix will provide replacements of either the hardware interface or
  130.     The A64 Package should either become damaged.  Replacements will be made
  131.     available to registered owners only and will cost a nominal fee.  Please
  132.     contact QuesTronix for exact details on replacements.
  133.  
  134.  
  135. TECHNICAL SUPPORT
  136.  
  137.     QuesTronix will provide technical support to REGISTERED OWNERS ONLY!  To
  138.     become a registered owner you must fill out the registration form and mail
  139.     it with the license fee to QuesTronix (See HOW TO BECOME A REGISTERED OWNER
  140.     in the INTRODUCTION section).
  141.  
  142.  
  143. HOW TO CONTACT QUESTRONIX
  144.  
  145.     QuesTronix's phone number has deliberately been omitted from The A64
  146.     Package.  We do not have the resources to answer phone calls from
  147.     unregistered users.  Upon becoming a registered owner QuesTronix will make
  148.     its phone number available to you.  Until then you may contact QuesTronix
  149.     by writing to:
  150.  
  151.                                   QuesTronix
  152.                                 P.O. Box 340285
  153.                             Hartford, CT 06134-0285
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.                                                                         2
  162.  
  163.  
  164.  
  165. -
  166.  
  167.  
  168.  
  169. TRADEMARKS
  170.  
  171.     The A64 Package, A64, A64 BASIC, A64 Prefs, A64Mon and QuesTronix are
  172.         trademarks of QuesTronix.
  173.  
  174.     Commodore 64 and C64 are trademarks and COMMODORE is a registered trademark 
  175.         of Commodore Electronics, Ltd.
  176.  
  177.     Amiga, AmigaDOS and Workbench are registered trademarks of
  178.         Commodore-Amiga, Inc.
  179.  
  180.     GO-64! is a trademark of Software Insight Systems, Inc.
  181.  
  182.     The 64 Emulator is a trademark of ReadySoft, Inc.
  183.  
  184.     Deluxe Paint is a trademark of Electronic Arts.
  185.  
  186.     PrintShop is a trademark of Broderbund Software.
  187.  
  188.     GEOS is a trademark of Berkely Softworks.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.                                                                           3
  228.  
  229.  
  230.  
  231. -
  232.  
  233.  
  234.  
  235. TABLE OF CONTENTS
  236.  
  237.     COPYRIGHT .........................................................    1
  238.     LICENSE AGREEMENT .................................................    1
  239.     DISCLAIMER ........................................................    1 
  240.     CREDITS ...........................................................    1
  241.     SYSTEM REQUIREMENTS ...............................................    2
  242.     UPDATES ...........................................................    2
  243.     REPLACEMENTS.......................................................    2
  244.     TECHNICAL SUPPORT .................................................    2
  245.     HOW TO CONTACT QUESTRONIX .........................................    2
  246.     TRADEMARKS ........................................................    3
  247.  
  248.     INTRODUCTION ......................................................  1-1
  249.         WHAT IS THE A64 PACKAGE? ......................................  1-1
  250.         WHAT IS NEEDED? ...............................................  1-1
  251.         WHAT DOES IT COST? ............................................  1-2
  252.         HOW TO BECOME A REGISTERED OWNER ..............................  1-2
  253.         A NOTE FROM THE AUTHOR ........................................  1-3
  254.  
  255.     GETTING STARTED ...................................................  2-1
  256.        RUNNING A64 ....................................................  2-1
  257.        A64'S HARDWARE INTERFACE .......................................  2-3
  258.        INSTALLING A64'S HARDWARE INTERFACE ............................  2-3
  259.        INSTALLING THE A64 PACKAGE ON ANOTHER DISK OR HARD DISK ........  2-4
  260.  
  261.     A64 PREFS .........................................................  3-1
  262.         A64 PREFS SETTINGS AND CONFIGURATION FILES ....................  3-1
  263.         THE MENUS .....................................................  3-2
  264.  
  265.         THE PROJECT MENU ..........................................  3-2
  266.                 RESET A64 .............................................  3-2
  267.             LOAD CONFIG ...........................................  3-2
  268.             SAVE CONFIG ...........................................  3-3
  269.             NAMING CONFIGURATION FILES ........................  3-3
  270.             RESET CONFIG ..........................................  3-4
  271.             ABOUT A64 .............................................  3-4
  272.             QUIT A64 ..............................................  3-4
  273.             EXIT PREFS ............................................  3-5
  274.  
  275.         THE SYSTEM MENU ...........................................  3-6
  276.             PAR PORT ..............................................  3-6
  277.             SER PORT ..............................................  3-6
  278.             MODEMS ............................................  3-7
  279.             GAME PORTS (JOYSTICKS) ................................  3-7
  280.             SWAP PORTS GADGET .................................  3-7
  281.                     PORT 1 AND PORT 2 GADGETS .........................  3-8
  282.             DRIVES ................................................  3-9
  283.             AMIGA DRIVES ......................................  3-10
  284.  
  285.         THE GRAFIX MENU ...........................................  3-11
  286.             COLORS ................................................  3-11
  287.             COLOR GADGETS .....................................  3-11
  288.             SLIDER GADGETS ....................................  3-12
  289.             COLOR MODE GADGET .................................  3-12
  290.                 20 COLOR MODE .................................  3-13
  291.                 16 COLOR MODE .................................  3-13
  292.  
  293.                                                                           4
  294.  
  295.  
  296.  
  297. -
  298.  
  299.  
  300.  
  301.                 2, 4, & 8 COLOR MODES .........................  3-14
  302.             BORDERS ...............................................  3-15
  303.             SCREEN REFRESH ........................................  3-16
  304.             DIRECT MODE .......................................  3-16
  305.             SAMPLE MODE .......................................  3-16
  306.  
  307.         THE TOOLS MENU ............................................  3-17
  308.             SAVE SCREEN ...........................................  3-17
  309.  
  310.         A64 PREFS NOTES ...............................................  3-18
  311.  
  312.     UTILITIES .........................................................  4-1
  313.         UTILITY SUMMARY ...............................................  4-1
  314.             CONVENTIONS FOR THE CLI BASED UTILITIES ...................  4-1
  315.         64Cmd .........................................................  4-3
  316.         64Dir .........................................................  4-4
  317.         64Print .......................................................  4-5
  318.         64Status ......................................................  4-6
  319.         64ToAmiga .....................................................  4-7
  320.         AmigaTo64 .....................................................  4-8
  321.         InstallA64Font ................................................  4-9
  322.         Pet2ASCII .....................................................  4-10
  323.         PrintFile .....................................................  4-11
  324.         StripLoadAddr .................................................  4-12
  325.         C64 PROGRAMS ..................................................  4-13
  326.             SaveROMs ..................................................  4-13
  327.             64Colors ..................................................  4-13
  328.  
  329.     TECHNICAL .........................................................  5-1
  330.          THE A64 PACKAGES FILE STRUCTURE ..............................  5-1
  331.          THE KEYBOARD .................................................  5-2
  332.          KEYBOARD DIFFERENCES .....................................  5-2
  333.          A PROBLEM WITH THE KEYBOARD ..............................  5-2
  334.          THE NUMERIC KEYPAD .......................................  5-2
  335.          UNUSED KEYS ..............................................  5-3
  336.          A64 AND MULTITASKING .........................................  5-4
  337.          A64 AND MEMORY ...............................................  5-4
  338.          680x0 SUPPORT ................................................  5-5
  339.          ROMS .........................................................  5-6
  340.              WHAT IS ROM? .............................................  5-6
  341.              THE C64'S ROMS ...........................................  5-6
  342.              A64'S ROMS ...............................................  5-6
  343.              INSTALLING THE C64'S ROMS ................................  5-7
  344.  
  345.       PROBLEMS AND SOLUTIONS ..........................................  6-1
  346.         A64 ERRORS ....................................................  6-2
  347.         ERROR LIST ................................................  6-3
  348.         INCOMPATIBILITIES .............................................  6-9
  349.         KNOWN BUGS ....................................................  6-10
  350.  
  351.       WHAT IS IN THE FUTURE ...........................................  7-1
  352.  
  353.       APPENDICES .......................................................   A
  354.           ERROR REPORT .................................................   A
  355.  
  356.  
  357.  
  358.  
  359.                                                                           5
  360.  
  361.  
  362.  
  363. -
  364.  
  365.  
  366.  
  367. INTRODUCTION
  368.  
  369.     Welcome to The A64 Package.  This manual assumes that you are familiar with
  370.     the basic usage of the CLI and WorkBench.  If you are not please consult
  371.     your Amiga user's guide.  This manual also makes the assumption that you
  372.     are familiar with using the Commodore 64.  If you want to learn more about
  373.     using the Commodore 64 there are many good books available on the subject.
  374.  
  375.     Throughout this manual some names are used that we would like to clarify.
  376.     When you see the name "The A64 Package" we are referring to the entire
  377.     package including all its utilities.  When you see the name "A64" by itself
  378.     we are referring only to the A64 program.  The names: "A64's hardware
  379.     interface","hardware interface" or just "interface" all refer to the same
  380.     interface.
  381.  
  382.     The bulk of this manual is for describing the use and function of A64.  The
  383.     descriptions and instructions for all of The A64 Packages' utilities can be
  384.     found in the UTILITIES section.  We recommend that you fully read this
  385.     manual before attempting to use any of the programs included with The A64
  386.     Package.
  387.  
  388.  
  389. WHAT IS THE A64 PACKAGE?
  390.  
  391.     The A64 Package is a collection of Amiga programs to help Commodore 64
  392.     users upgrade to the Amiga.  We like to call The A64 Package "a Commodore
  393.     64 upgrade kit."  Commodore 64 owners have spent hundreds or even thousands
  394.     of dollars on their C64 peripherals and software.  Many of them would like
  395.     to upgrade to the Amiga, but they do not want to lose their investment.
  396.     There is a solution!  The A64 Package will allow them to continue to use
  397.     their familiar Commodore 64 software and peripherals while they're learning
  398.     how to use their powerful, new Amiga.  The main program included with The
  399.     A64 Package is A64.  A64 is a Commodore 64 emulator.  The word emulate
  400.     means to strive to equal or excel, especially through imitation.  A64
  401.     emulates the Commodore 64.  This means that using A64 is just like using a
  402.     C64.  There are literally thousands of programs available for the Commodore
  403.     64 and A64 will run a majority of them.  The A64 Package also includes
  404.     several utilities to help with the transfer of data or programs from the
  405.     Commodore 64 to the Amiga and back again.  Now bridging the gap from the
  406.     Commodore 64 to the Amiga is easier than ever before.  The A64 Package
  407.     helps to make the upgrade path a little easier to take.
  408.  
  409.  
  410. WHAT IS NEEDED?
  411.  
  412.     The A64 Package is a hardware and software combination.  The software, the
  413.     A64 program and its associated utilities, perform the actual Commodore 64
  414.     emulation and allow you to transfer data or programs from C64 drives to
  415.     Amiga drives and back again.  The hardware is an interface that plugs into
  416.     the parallel port of your Amiga 500 or 2000 and allows The A64 Package to
  417.     access Commodore 64 disk drives and printers.  A separate adapter cable is
  418.     needed for the A1000.  You already have the software and the hardware is
  419.     available from QuesTronix.  You DO NOT need the hardware to use A64, but
  420.     without it, its use is very limited.  You DO need the hardware to use most
  421.     of The A64 Packages' utility programs.
  422.  
  423.  
  424.  
  425.                                                                         1-1
  426.  
  427.  
  428.  
  429. -
  430.  
  431.  
  432. EXTRA HARDWARE
  433.  
  434.     The adapter cable needed for the A1000 is available for an additional
  435.     $20.00.  Please add $3.00 for shipping and handling if you order the
  436.     adapter cable separately.
  437.  
  438.  
  439. HOW TO BECOME A REGISTERED OWNER
  440.  
  441.     Included with The A64 Package is the file "Registration.form".  This file
  442.     serves as a registration form for The A64 Package.  Please print this file
  443.     (See PrintFile in the UTILITIES section) and then fill it out and send it
  444.     to:
  445.  
  446.                                   QuesTronix
  447.                                 P.O. Box 340285
  448.                             Hartford, CT 06134-0285
  449.  
  450.  
  451.     Please take the time to fill out the registration form completely.  The
  452.     information you put on it will help us to put out better updates of The
  453.     A64 Package.  Users without printers can substitute the registration form
  454.     with a letter. 
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.                                                                         1-2
  479.  
  480.  
  481.  
  482. -
  483.  
  484.  
  485.  
  486.  A NOTE FROM THE AUTHOR
  487.  
  488.     Those of you that have been around the Amiga community for a while know all
  489.     about C64 emulators and what a disappointment they have been.  I hope that
  490.     A64 is going to change that.  I decided to write A64 because I knew that a
  491.     C64 emulator could be faster and more compatible than the two commercially
  492.     available emulators.  Seeing how I was co-author of one of them (GO-64!),
  493.     I had a slight advantage in writing another emulator.  A64 V1.00n is the
  494.     first release in my attempt to write a better emulator and I see many
  495.     improvements and more features in the future.  Although I believe that The
  496.     A64 Package, in its current state, to be useful and in many ways superior
  497.     to the competitors packages, it still needs quite a bit of work to be the
  498.     best it can be.  Unfortunately writing a program as complex as a C64
  499.     emulator takes a great deal of time and for QuesTronix to continue
  500.     development of The A64 Package we needs your support.
  501.  
  502.                             Thanks in advance,
  503.                             Cliff Dugan
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.                                                                         1-3
  542.  
  543.  
  544.  
  545. -
  546.  
  547.  
  548.  
  549. GETTING STARTED
  550.  
  551.     If you already have A64's hardware interface you should install it before
  552.     running A64 (See INSTALLING A64'S HARDWARE INTERFACE in the GETTING STARTED
  553.     section).
  554.  
  555.  
  556. RUNNING A64
  557.  
  558.     To run A64 you should have:
  559.  
  560.         1. A copy of WorkBench that can be to written to.  You can either use
  561.            the WorkBench that you usually use with your Amiga or make a copy of
  562.            it.  If you decide to use your normal WorkBench you should note that
  563.            a font will be added to it and it should have enough room on it to
  564.            store this font (less than 1%).  You should make sure that the
  565.            WorkBench disk contains the following directories and files:
  566.  
  567.            "C" directory containing the files "Execute, Assign, Path and Copy"
  568.            "Libs" directory containing the file "diskfont.lib"
  569.            "Fonts" directory
  570.  
  571.         2. A separate disk containing The A64 Package, which should be in the
  572.        directory named "TheA64Package."
  573.  
  574.     Before you can run A64 you must install a font onto the WorkBench disk that
  575.     you will be using with The A64 Package.  This is easily done by using the
  576.     program "InstallA64Font" that is included with The A64 Package (See
  577.     InstallA64Font in the UTILITIES section).  The procedure for installing the
  578.     font, from the WorkBench, is as follows:
  579.  
  580.         1. Insert the disk containing The A64 Package into any drive.
  581.         2. Double-click The A64 Packages' disk icon. 
  582.         3. When the disk window appears double-click TheA64Package drawer icon.
  583.         4. When the drawer window appears you will see an icon that is named
  584.            "InstallA64Font," double-click this icon.
  585.         5. A window will appear asking you to enter the name of the drive
  586.            containing The A64 Package.  You should enter the name of drive and
  587.            press the RETURN key when you are done.  For example, if the drive
  588.            containing The A64 Package was drive 1 then you would enter: df1:
  589.            and then press return.
  590.         6. The A64 font will then be installed to your WorkBench fonts
  591.            directory.  If you have a single drive system just swap disks when
  592.            needed.
  593.  
  594.     To run InstallA64Font from the CLI, type the following:
  595.  
  596.         cd TheA64Package
  597.     run InstallA64Font
  598.  
  599.         You can now follow the procedure listed above, starting at step 5.
  600.  
  601.     The installation of the A64 Font only needs to be done once as long as you
  602.     always use the same WorkBench disk with A64.  If you change WorkBench disks
  603.     you will have to install the A64 Font on the new WorkBench disk.
  604.  
  605.  
  606.  
  607.                                                                         2-1
  608.  
  609.  
  610.  
  611. -
  612.  
  613.  
  614.  
  615.     After installing the A64 Font you are now ready to run A64.  If you still
  616.     have TheA64Package drawer window open from installing the A64 Font you can
  617.     go directly to step 4.
  618.  
  619.         1. Insert the disk containing The A64 Package into any drive.
  620.         2. Double-click The A64 Packages' disk icon. 
  621.         3. When the disk window appears double-click TheA64Package drawer icon.
  622.         4. You will see an icon named "A64" that looks like an Amiga 2000,
  623.            double-click it.
  624.         5. You will then see A64's title screen.  There will be a brief pause
  625.            while A64 loads its files.  After it's done loading you will see a
  626.            message flashing on the lower left hand side of the screen saying
  627.            "PRESS A MOUSE BUTTON."  At this time you should do so.
  628.         6. You will then be shown A64's license agreement screen.  You should
  629.            read this entire screen before proceeding.  If you agree to the
  630.            terms listed on the screen you should press the left mouse button to
  631.            enter A64.  If you do not agree to the terms you should press the
  632.            right mouse button to quit A64.
  633.  
  634.     To run A64 from the CLI, type the following:
  635.  
  636.         cd TheA64Package
  637.     run A64
  638.  
  639.         Make sure you type run before A64 to take advantage of A64's
  640.         multitasking capabilities.  You can now follow the procedure for
  641.         running A64 starting at step 5.
  642.  
  643.     Assuming you agreed to the terms of the license agreement and pressed the
  644.     left mouse button, you will now be shown the A64 BASIC screen.  The A64
  645.     BASIC screen will differ from the C64 BASIC screen in two ways:
  646.  
  647.        1. The startup message will say "*** QUESTRONIX A64 BASIC V1 ***"
  648.           instead of "**** COMMODORE 64 BASIC V2 ****."  This is because the
  649.           Commodore 64 ROMs are not present in A64 (See ROMS in the TECHNICAL
  650.           section).
  651.        2. There will be no borders around the screen. (See BORDERS in the
  652.           GRAFIX MENU section).
  653.  
  654.     You have now turned your Amiga into a C64.  You can do almost everything in
  655.     A64 that you would do on a C64.  You can try all the BASIC commands or POKE
  656.     and PEEK around memory. It's all there.
  657.  
  658.     NOTE: While the A64's title screen is being displayed you can press the
  659.           TAB key to cycle the background.  Pressing it again will stop the
  660.           cycling.
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.                                                                         2-2
  674.  
  675.  
  676.  
  677. -
  678.  
  679.  
  680.  
  681. A64'S HARDWARE INTERFACE
  682.  
  683.     To fully utilize The A64 Package you need its hardware interface.  This
  684.     interface is a small hardware box that plugs into the parallel port of
  685.     your Amiga 500 or 2000.  A separate adapter cable is required for the Amiga
  686.     1000.  This interface allows you to connect your Commodore 64 disk drive
  687.     and printers to the Amiga in the same way you would connect them to your
  688.     C64.  It's this interface that allows you to load and save C64 programs
  689.     from C64 disk drives and transfer them to and from Amiga disks.  The
  690.     hardware interface is not absolutely required to use A64, but without it,
  691.     its use is very limited.  To get the interface you must become a registered
  692.     owner of The A64 Package (See HOW TO BECOME A REGISTERED OWNER in the
  693.     INTRODUCTION section).
  694.  
  695.  
  696. INSTALLING A64'S HARDWARE INTERFACE
  697.  
  698.     The hardware interface is a small box with two connectors on it.  The large
  699.     connector is the end that plugs into your Amiga and the small connector is
  700.     the end where you plug in your C64 disk drives and printers. 
  701.  
  702.     To install the hardware interface use the following procedure:
  703.  
  704.     1. Make sure your Amiga is turned off.  You should NEVER plug anything into
  705.        your Amiga while it's turned on, because damage to your Amiga could
  706.        result by doing so.
  707.     2. If you have the Amiga 500 or 2000 you may now plug the interface
  708.        directly into its parallel port.  If you have the Amiga 1000 you must
  709.        first plug the adapter cable into the parallel port and then connect the
  710.        interface to the cable.  Please note that this adapter cable is not a
  711.        simple gender changer and only a cable specifically made to connect
  712.        A500/A2000 devices to an A1000 parallel port should be used.
  713.     3. You are now ready to connect your C64 disk drives and printers to the
  714.        interface.  Make sure that each C64 device that you wish to connect has
  715.        its power turned off.  Using the serial cable that came with your disk
  716.        drive or printer,  plug one end of the cable into the interface and the
  717.        other into your C64 peripheral.  The C64 peripherals may now be "daisy
  718.        chained" in the same way as they would be on a C64, by plugging each new
  719.        device into the back of each previous device.  After all C64 devices are
  720.        connected you can then turn them on.  A64 will support up to four
  721.        different C64 disk drives and two separate C64 printers, simultaneously.
  722.     4. You may now turn on your Amiga and boot it up as you normally would.
  723.  
  724.     The hardware interface can stay plugged in at all times without interfering
  725.     with any programs on your Amiga, as long as they do not use the parallel
  726.     port.  If you want to use your parallel port with some other piece of
  727.     hardware, like a printer or digitizer, you must remove the hardware
  728.     interface and install the other device as you normally would.  You can also
  729.     use an A-B switch and just switch between devices.  Please note that A64
  730.     takes over the parallel port and for the parallel port to be used by other
  731.     devices while A64 is running certain procedures must by followed (See PAR
  732.     PORT in the SYSTEM MENU section).
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.                                                                         2-3
  740.  
  741.  
  742.  
  743. -
  744.  
  745.  
  746.  
  747. INSTALLING THE A64 PACKAGE ON ANOTHER DISK OR HARD DISK
  748.  
  749.     To install The A64 Package on another floppy disk or hard disk all you need
  750.     to do is copy TheA64Package directory (drawer) to the disk you want to
  751.     install it on.  The way to do this is as follows:
  752.  
  753.     From the WorkBench:
  754.  
  755.        drag the TheA64Package drawer to the destination disk.
  756.  
  757.     From the CLI type:
  758.  
  759.        makedir <destination disk>TheA64Package
  760.        copy <source disk>TheA64Package <destination disk>TheA64Package all
  761.        copy <source disk>TheA64Package.info <destination disk>
  762.  
  763.     <source disk> is the disk containing TheA64Package directory and
  764.     <destination disk> is the disk you want to install The A64 Package on.
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.                                                                         2-4
  806.  
  807.  
  808.  
  809. -
  810.  
  811.  
  812.  
  813. A64 PREFS
  814.  
  815.     A64 Prefs utilizes an Intuition user interface with menus, requesters and
  816.     gadgets.  This manual assumes that you are familiar with using this type of
  817.     user interface and the terms used to describe it.  If you are not familiar
  818.     with them please consult your Amiga user's manual.
  819.  
  820.     A64 is the Amiga's first truly multitasking Commodore 64 emulator and A64
  821.     Prefs is your bridge, from A64, to the multitasking environment.  A64 Prefs
  822.     allows A64 to have features you've come to expect from Amiga programs, like
  823.     an Intuition user interface with menus and requesters.  A64 Prefs allows
  824.     you to change the way A64 is configured to run C64 programs, access tools
  825.     included with The A64 Package and, most importantly, it allows you to stop
  826.     any C64 program that A64 is currently running and return to the WorkBench,
  827.     after which you can use A64 Prefs and re-enter the C64 program and pick up
  828.     EXACTLY where you left off.  A64 Prefs gives A64 the power and flexibility
  829.     that, until now, no C64 emulator has had.
  830.  
  831.     To gain access to A64 Prefs from A64 press the [LEFT ALT] key and the
  832.     [RIGHT ALT] key simultaneously.  After doing so a title bar will appear on
  833.     the C64 program that is currently running.  At this point you can get back
  834.     to the Workbench or CLI by dragging the screen down or by depth arranging
  835.     the A64 Prefs screen by using the front-back gadgets.  To get back to A64
  836.     Prefs you do the same thing, drag or depth arrange any other screen that
  837.     may visible.  You can also use the following key sequences to depth arrange
  838.     the A64 Prefs screen with the Workbench screen:
  839.  
  840.     [LEFT AMIGA] [M]: Send Workbench to back, A64 Prefs to front
  841.     [LEFT AMIGA] [N]: Send Workbench to front, A64 Prefs to back
  842.  
  843.  
  844. A64 PREFS SETTINGS AND CONFIGURATION FILES
  845.  
  846.     A64 Prefs effects the operation of A64 much like the WorkBench Preferences
  847.     program effects the operation of the Amiga.  By changing A64 Prefs'
  848.     settings you can force A64 to change its performance or appearance, in the
  849.     way that it runs a C64 program.  All of A64 Prefs' settings are accessed
  850.     with menus and requesters.  When you change one or more of these settings
  851.     they become the current settings, meaning they will take effect immediately
  852.     or when A64 is re-entered.  These settings will stay in effect until you
  853.     change them again or until you quit A64.  You can also save all of A64
  854.     Prefs' settings in what is called a "configuration file."  Unlike the
  855.     WorkBench Preferences program, A64 Prefs allows you to create as many
  856.     different configuration files as you like and name them what ever you
  857.     choose.
  858.  
  859.     The procedure for changing A64 Prefs' settings and loading and saving
  860.     configuration files is detailed in THE MENUS section.
  861.  
  862.     NOTE: A64 has a default configuration file.  This file is named
  863.           "A64.config" and it is loaded anytime you run A64.  It contains all
  864.           of A64's initial settings, which are shown by A64Prefs' menus and
  865.           requesters.  By changing any one or more of A64 Prefs' settings and
  866.           saving them with the name "A64.config" will force A64 to use your new
  867.           settings as its initial settings.
  868.  
  869.  
  870.  
  871.                                                                         3-1
  872.  
  873.  
  874.  
  875. -
  876.  
  877.  
  878.  
  879. THE MENUS
  880.  
  881.     A64 Prefs is broken up into several menus.  Each having its own function
  882.     and options.  All of A64 Prefs settings and features are accessed with
  883.     these menus.  Each menu and its options are described in the following
  884.     sections.
  885.  
  886.  
  887. THE PROJECT MENU
  888.  
  889.  
  890. RESET A64
  891.  
  892.     KEY SEQUENCE: [LEFT AMIGA] [N] (New)
  893.  
  894.     The RESET A64 menu option allows you to reset A64 back to its initial
  895.     state.  If selected, this option will terminate the program that A64 is
  896.     currently running and return A64 to the BASIC startup screen.  Essentially,
  897.     this is the same thing as turning a Commodore 64 off and then on again.
  898.  
  899.     When selecting RESET A64 you will be prompted with a requester asking you
  900.     "Are sure you want to reset A64?".  Select one of the requester's gadgets
  901.     to answer the question:
  902.  
  903.         YES, Reset A64.
  904.  
  905.         NO, Abort the procedure.
  906.  
  907.     NOTES: RESET A64 is non-destructive.  Any programs that were in memory
  908.            before the reset will still be there after the reset.
  909.  
  910.            RESET A64 does not reset any devices connected with A64's hardware
  911.            interface (i.e., C64 disk drives and printers).  If you were using
  912.            a program that used copy protection and/or sent commands to the
  913.            devices you may have to reset them by turning them off and then on
  914.            again.
  915.  
  916.  
  917. LOAD CONFIG
  918.  
  919.     KEY SEQUENCE: [LEFT AMIGA] [L] (Load)
  920.  
  921.     The LOAD CONFIG menu option allows you to load a previously saved
  922.     configuration file.  If selected, this option will load the requested
  923.     configuration file and the newly loaded settings will become A64 Prefs'
  924.     current settings.
  925.  
  926.     When selecting LOAD CONFIG you will be prompted with a requester asking
  927.     you to enter the name of the configuration file you wish to load.  Use the
  928.     requester's string gadget to enter the name and then press the RETURN key
  929.     to load the file.  You can also use the requester's other gadgets to
  930.     select the following:
  931.  
  932.         OK, Load the configuration file (pressing RETURN does the same).
  933.  
  934.         CANCEL, Abort the procedure.
  935.  
  936.  
  937.                                                                         3-2
  938.  
  939.  
  940.  
  941. -
  942.  
  943.  
  944.  
  945.     NOTE: The filename can contain any legal AmigaDOS path name, limited to 31
  946.           characters in length.
  947.  
  948.     SEE:  A64 PREFS SETTINGS AND CONFIGURATION FILES and SAVE CONFIG in the
  949.           A64 PREFS section.
  950.  
  951.  
  952. SAVE CONFIG
  953.  
  954.     KEY SEQUENCE: [LEFT AMIGA] [S] (Save)
  955.  
  956.     The SAVE CONFIG menu option allows you to save the current A64 Prefs'
  957.     settings.  If selected, this option will save all of A64 Prefs' current
  958.     settings in the configuration file that you specified, to be loaded at a
  959.     later time.
  960.  
  961.     When selecting SAVE CONFIG you will be prompted with a requester asking
  962.     you to enter the name of the configuration file you wish to save A64
  963.     Prefs' current settings to.  Use the requester's string gadget to enter the
  964.     name and then press the RETURN key to save the file.  You can also use the
  965.     requester's other gadgets to select the following:
  966.  
  967.         OK, Save the configuration file (pressing RETURN does the same).
  968.  
  969.         CANCEL, Abort the procedure.
  970.  
  971.     NOTES: The filename can contain any legal AmigaDOS path name, limited to 31
  972.            characters in length.
  973.  
  974.            You can change the default A64 Prefs' settings, the settings used
  975.            when A64 is first loaded, by saving the current settings with the
  976.            name "A64.config".  This configuration file is always loaded
  977.            whenever you run A64.
  978.  
  979.     SEE:   A64 PREFS SETTINGS AND CONFIGURATION FILES and LOAD CONFIG and
  980.            NAMING CONFIGURATION FILES in the A64 PREFS section.
  981.  
  982.  
  983. NAMING CONFIGURATION FILES
  984.  
  985.     It is a good practice to end your configuration files with the file
  986.     extension ".config".  This will help you to remember what you named your
  987.     configuration files.  For example, if you saved a configuration file for
  988.     the C64 program "PrintShop" and you named it "PrintShop.config" then when
  989.     loading the file at a future time you would have no problem remembering
  990.     what you named it.
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.                                                                         3-3
  1004.  
  1005.  
  1006.  
  1007. -
  1008.  
  1009.  
  1010.  
  1011. RESET CONFIG
  1012.  
  1013.     KEY SEQUENCE: [LEFT AMIGA] [R] (Reset config)
  1014.  
  1015.     The RESET CONFIG menu option allows you to reset A64 Prefs' current
  1016.     settings to their default states.  If selected, this option will reset all
  1017.     of A64 Prefs' settings to their original settings.
  1018.  
  1019.     When selecting RESET CONFIG you will be prompted with a requester asking
  1020.     you "Are sure you want to reset config?".  Select one of the requester's
  1021.     gadgets to answer the question:
  1022.  
  1023.         YES, Reset the configuration settings.
  1024.  
  1025.         NO, Abort the procedure.
  1026.  
  1027.     NOTE: The default settings set by RESET CONFIG are not necessarily the ones
  1028.           currently saved in the default configuration file "A64.config".  If
  1029.           you have changed this file and you want to reset it to the default
  1030.           settings you must save them with the name "A64.config".
  1031.  
  1032.     SEE:  A64 PREFS SETTINGS AND CONFIGURATION FILES and SAVE CONFIG in the
  1033.           A64 PREFS section.
  1034.  
  1035.  
  1036. ABOUT A64
  1037.  
  1038.     KEY SEQUENCE: [LEFT AMIGA] [A] (About)
  1039.  
  1040.     The ABOUT A64 menu option allows you to read some information about A64.
  1041.  
  1042.     When selecting ABOUT A64 you will be shown a screen with a cycling blue
  1043.     background.  On the screen will be a requester with some information about
  1044.     A64.  After you have read the information you can select the requester's
  1045.     OK gadget to return to A64 Prefs.
  1046.  
  1047.  
  1048. QUIT A64
  1049.  
  1050.     KEY SEQUENCE: [LEFT AMIGA] [Q] (Quit)
  1051.  
  1052.     The QUIT A64 menu option allows you to quit A64.  If selected, this option
  1053.     will terminate A64 for good and return you to the WorkBench.
  1054.  
  1055.     When selecting QUIT A64 you will be prompted with a requester asking you
  1056.     "Are sure you want to quit A64?".  Select one of the requester's gadgets
  1057.     to answer the question:
  1058.  
  1059.         YES, Quit A64.
  1060.  
  1061.         NO, Abort the procedure.
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.                                                                         3-4
  1070.  
  1071.  
  1072.  
  1073. -
  1074.  
  1075.  
  1076.  
  1077. EXIT PREFS
  1078.  
  1079.     KEY SEQUENCE: [LEFT AMIGA] [X] (eXit)
  1080.  
  1081.     The EXIT PREFS menu option will allow you to exit A64 Prefs and return to
  1082.     A64.  If selected, this option will close A64 Prefs and return you to A64
  1083.     at the exact point where you left it.
  1084.  
  1085.     When selecting EXIT PREFS you will be prompted with a requester asking you
  1086.     "Are sure you want to exit prefs?".  Select one of the requester's gadgets
  1087.     to answer the question:
  1088.  
  1089.         YES, Exit A64 Prefs and return to A64.
  1090.  
  1091.         NO, Abort the procedure.
  1092.  
  1093.     NOTE: You can get back to A64 Prefs by pressing the [LEFT ALT] key and the
  1094.           [RIGHT ALT] key simultaneously.
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.                                                                         3-5
  1136.  
  1137.  
  1138.  
  1139. -
  1140.  
  1141.  
  1142.  
  1143. THE SYSTEM MENU
  1144.  
  1145.  
  1146. PAR PORT
  1147.  
  1148. KEY SEQUENCE: None
  1149.  
  1150.     The PAR PORT menu option allows you to toggle ownership of the Amiga's
  1151.     parallel port between A64 and other Amiga programs.  Because A64 takes over
  1152.     the Amiga's parallel port for its hardware interface, it can only be used
  1153.     by either A64 or other Amiga programs at any one time.
  1154.  
  1155.     The PAR PORT menu option has two settings: AMIGA and A64. You can select
  1156.     one or the other of these settings and selecting one automatically
  1157.     unselects the other.  The current selected setting is shown by displaying
  1158.     a checkmark next to it.  To use A64's hardware interface, A64 must own the
  1159.     parallel port and the A64 setting must be selected.  If you want to use
  1160.     some other program, while A64 is running, that needs the parallel port for
  1161.     some other piece of hardware (i.e., parallel printers or digitizers) then
  1162.     the Amiga must own the parallel port and the AMIGA setting must be
  1163.     selected.
  1164.  
  1165.     NOTES: The A64 setting should only be selected when the A64 program itself
  1166.            needs the parallel port.  If you want to use the utility programs
  1167.            included with The A64 Package, that also need A64's hardware
  1168.            interface (i.e., 64Dir, 64ToAmiga, AmigaTo64, etc.), the AMIGA
  1169.            setting must be selected.
  1170.  
  1171.     IMPORTANT NOTE: See KNOWN BUGS in the PROBLEMS AND SOLUTIONS section!
  1172.  
  1173.  
  1174. SER PORT
  1175.  
  1176.     KEY SEQUENCE: None
  1177.  
  1178.     The SER PORT menu option allows you to toggle ownership of the Amiga's
  1179.     serial port between A64 and other Amiga programs.  Because A64 takes over
  1180.     the Amiga's serial port for using modems, it can only be used by either
  1181.     A64 or other Amiga programs at any one time.
  1182.  
  1183.     The SER PORT menu option has two settings: AMIGA and A64. You can select
  1184.     one or the other of these settings and selecting one automatically
  1185.     unselects the other.  The current selected setting is shown by displaying
  1186.     a checkmark next to it.  To use modems with A64, A64 must own the serial
  1187.     port and the A64 setting must be selected.  If you want to use some other
  1188.     program, while A64 is running, that needs the serial port for some other
  1189.     piece of hardware (i.e., serial printers or modems with Amiga programs)
  1190.     then the Amiga must own the serial port and the AMIGA setting must be
  1191.     selected.
  1192.  
  1193.     NOTE: You should not change the SER PORT setting to AMIGA while A64 is
  1194.           running a C64 telecommunications program.  This could cause the C64
  1195.           program to lose data and possibly crash, forcing you to reset A64.
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.                                                                         3-6
  1202.  
  1203.  
  1204.  
  1205. -
  1206.  
  1207.  
  1208.  
  1209. MODEMS
  1210.  
  1211.     A64 supports Amiga modems.  To use an Amiga modem with A64 you must make
  1212.     sure the SER PORT menu item is set to A64 (See SER PORT in the SYSTEM MENU
  1213.     section).  You do not have to set BAUD, PARITY or other telecommunications
  1214.     parameters with either A64 Prefs or the WorkBench Preferences program. The
  1215.     C64 program that A64 is running will set these parameters.  A64 does not
  1216.     support BAUD rates of 50 and 75 which are available on the C64, but it does
  1217.     support all common BAUD rates from 110 to 19200. 
  1218.  
  1219.    NOTE: A64's modem support is still in development and C64 telecommunications
  1220.          programs may or may not fully work.  For the best results with A64
  1221.          V1.00n try to use C64 programs that use the following settings: NO
  1222.          PARITY, 300 or 1200 BAUD, 1 STOP BIT, 8 DATA BITS and 3-LINE protocol.
  1223.          Modem support will be fully implemented by the next version of A64.
  1224.  
  1225.  
  1226. GAME PORTS (JOYSTICKS)
  1227.  
  1228.     KEY SEQUENCE: [LEFT AMIGA] [G] (Game port)
  1229.  
  1230.     The GAME PORTS menu option allows you to tell A64 what kind of input
  1231.     devices are connected to the Amiga's game ports (Game ports are the ports
  1232.     that you plug your Amiga mouse and joysticks into).
  1233.  
  1234.     In the following explanation of the GAME PORTS menu option, reference is
  1235.     made to each port in the following manner: port 1 means the port that your
  1236.     Amiga's mouse is normally plugged into and port 2 means the other port.  By
  1237.     default, port 1 on the Amiga corresponds to port 1 on the C64 and port 2 on
  1238.     the Amiga corresponds to port 2 on the C64.
  1239.  
  1240.     When selecting GAME PORTS, you will be prompted with a requester containing
  1241.     several gadgets. The function of each gadget is as follows:
  1242.  
  1243. SWAP PORTS GADGET 
  1244.  
  1245.     Selecting SWAP PORTS will toggle the game ports on the Amiga.  This is
  1246.     shown by toggling the gadget between YES and NO.  The meaning of both are
  1247.     as follows:
  1248.  
  1249.         NO, The Amiga's game ports act as normal. Port 1 on the Amiga
  1250.         corresponds to port 1 on the C64 and port 2 on the Amiga corresponds to
  1251.         port 2 on the C64.
  1252.  
  1253.         YES, The Amiga's game ports are swapped.  Port 1 on the Amiga will
  1254.         become port 2 on the C64 and port 2 on the Amiga will become port 1 on
  1255.         the C64.  This swapping of the ports is in reference to the actual
  1256.         game ports on the Amiga and not the PORT 1 and PORT 2 gadgets described
  1257.         below.
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.                                                                         3-7
  1268.  
  1269.  
  1270.  
  1271. -
  1272.  
  1273.  
  1274.  
  1275.    For example, you are using a C64 program that requires a joystick in port 1.
  1276.    Instead of unplugging your Amiga's mouse from port 1 you can plug the
  1277.    joystick into port 2 and select YES as the SWAP PORTS setting.  Now A64 will
  1278.    read the joystick as if it was plugged into port 1.  Please note that you
  1279.    must still set the PORT 1 gadget to JOYSTICKS as described below.  Also note
  1280.    that SWAP PORTS only effects how A64 reads the game ports and not how the
  1281.    Amiga and WorkBench read them.  With proper use, SWAP PORTS will allow you
  1282.    to use almost any C64 program and not have to unplug your Amiga's mouse,
  1283.    unless of course both game ports are required by the C64 program.
  1284.  
  1285. PORT 1 AND PORT 2 GADGETS
  1286.  
  1287.     Selecting PORT 1 or PORT 2 will allow you to change the input device for
  1288.     the corresponding C64 game port.  This is displayed by changing the name of
  1289.     the input device for the corresponding port.  Both of these gadgets work in
  1290.     the same way, except that PORT 1 corresponds to the C64's port 1 and PORT 2
  1291.     corresponds to the C64's port 2.  These gadgets ALWAYS correspond to the
  1292.     C64's game ports and not the Amiga's, regardless of the status of the SWAP
  1293.     PORTS gadget described above.  That means if a C64 program requires a
  1294.     joystick in port 1 you MUST set the PORT 1 gadget to JOYSTICKS.  Currently
  1295.     there are only two supported settings for these gadgets:
  1296.  
  1297.     JOYSTICKS: Selects joysticks for the corresponding C64 port.
  1298.  
  1299.     NO DEVICE: Acts as if there is no device connected regardless of what is
  1300.                actually plugged in.
  1301.  
  1302. OK GADGET
  1303.  
  1304.     Selecting OK will preserve all changes to the GAME PORTS settings.  They
  1305.     will become the current GAME PORTS settings and be active as soon as A64 is
  1306.     re-entered.
  1307.  
  1308. CANCEL GADGET
  1309.  
  1310.     Selecting CANCEL will ignore all changes to the GAME PORTS settings and
  1311.     abort the procedure.
  1312.  
  1313.     NOTES: While the PORT 1 gadget is set to JOYSTICKS and SWAP PORTS is set to
  1314.            NO the Amiga's mouse will interfere with the keyboard and characters
  1315.            will appear on the screen when the mouse is moved.  This is normal.
  1316.            The same thing will happen if you plug an Amiga mouse into port 1 of
  1317.            the C64.  This problem can be avoided by setting SWAP PORTS to YES
  1318.            or setting the PORT 1 gadget to NO DEVICE.  Also note, because of
  1319.            the way the SWAP PORTS gadget works this problem can also be created
  1320.            with the Amiga's game port 2.
  1321.  
  1322.            More input devices will be supported in future versions of A64.
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.                                                                         3-8
  1334.  
  1335.  
  1336.  
  1337. -
  1338.  
  1339.  
  1340.  
  1341. DRIVES
  1342.  
  1343.     KEY SEQUENCE: [LEFT AMIGA] [D] (Drives)
  1344.  
  1345.     The DRIVES menu option allows you to assign a type of disk drive to a drive
  1346.     number.  The Commodore 64 allows you to connect up to four disk drives to
  1347.     it.  A64 is no different in that it also allows you to utilize up to four
  1348.     drives, but unlike the C64, A64 allows you to use not only C64 drives, but
  1349.     you can also use Amiga drives.  The C64 uses drive numbers to access its
  1350.     drives.  Numbered 8-11.  A64 uses these same drive numbers and the DRIVES
  1351.     option allows you to assign a type of drive to them.
  1352.  
  1353.     When selecting DRIVES you will be prompted with a requester. On this
  1354.     requester you will see the numbers 8-11 on the left hand side of it.  These
  1355.     numbers correspond to the C64's drive numbers mentioned above.  To the
  1356.     right of each of these numbers are two gadgets.  The 1st gadget (going left
  1357.     to right) allows you to toggle between a C64 drive or an Amiga drive for
  1358.     that particular drive number.  This is displayed by showing the word C64 or
  1359.     AMIGA.  If you want to assign a C64 drive to a drive number you set this
  1360.     gadget to C64 and if you want to assign an Amiga drive to a drive number
  1361.     you set this gadget to AMIGA.  The second gadget is a string gadget and is
  1362.     only used when you the first gadget is set to AMIGA.  If you set the first
  1363.     gadget to C64 then this gadget will be disabled.  The purpose of the second
  1364.     gadget is to tell A64 what Amiga device you want to assign to a drive
  1365.     number.  This is done by typing in the device name that you want to assign
  1366.     to a drive number.  This name can be any Amiga drive or any valid AmigaDOS
  1367.     path name.  Some valid device names are: df0:, df1:, dh0:, and RAM:.  You
  1368.     can also use volume names like WorkBench 1.3: or directory names like
  1369.     df0:TheA64Package/64Prgs.
  1370.  
  1371.     For example, you want to load the C64 program named "64Colors" and this
  1372.     program is located on the The A64 Package disk in the 64Prgs directory,
  1373.     which itself is in the directory TheA64Package.  With the A64 disk in df0:
  1374.     you would do the following:
  1375.  
  1376.         1. Select the DRIVES menu option with either the mouse or key sequence.
  1377.         2. When the requester appears change drive 8 to AMIGA.  This is done by
  1378.            clicking on the first gadget (going left to right) next to the
  1379.            number 8.
  1380.         3. The string gadget will then become enabled.  Select the string
  1381.            gadget and type in the following:
  1382.  
  1383.                df0:The64Package/64Prgs [RETURN]
  1384.  
  1385.          4. Select the OK gadget so your changes will be preserved.
  1386.          5. Exit A64 Prefs using the EXIT PREFS menu item in the PROJECT menu.
  1387.          6. When you are back in A64 type in the following:
  1388.  
  1389.                 LOAD"64COLORS",8 [RETURN]
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.                                                                         3-9
  1400.  
  1401.  
  1402.  
  1403. -
  1404.  
  1405.  
  1406.  
  1407.     A64 will then load the program from the path you assigned to drive 8,
  1408.     "df0:The64Package/64Prgs."  You can now RUN the program as if were loaded
  1409.     from a C64 drive.  Now whenever you perform an action involving drive 8,
  1410.     A64 will act as if "df0:The64Package/64Prgs" is drive 8. Please note that
  1411.     you could also have assigned drive 8 to just df0: and typed the following
  1412.     when you re-entered A64:
  1413.  
  1414.                 LOAD"THEA64PACKAGE/64PRGS/64COLORS",8 [RETURN]
  1415.  
  1416.     The remaining two gadgets are as follows:
  1417.  
  1418.         OK will preserve all changes to the DRIVES settings. They will become
  1419.         the current DRIVES settings and be active as soon as A64 is re-entered.
  1420.  
  1421.         CANCEL will ignore all changes to the DRIVES settings and abort the
  1422.         procedure.
  1423.  
  1424.  
  1425. AMIGA DRIVES
  1426.  
  1427.     A64 supports Amiga drives for the loading and saving of programs and data
  1428.     to and from A64.  These drives can be floppy drives, hard drives and RAM
  1429.     drives.  But before you attempt to use any of these with A64 you must
  1430.     understand an important fact about using them.  They are not as compatible
  1431.     as using a C64 drive with A64 and their use is limited.  The reason for
  1432.     this is that C64 disk drives are what is referred to as "intelligent
  1433.     devices."  This means that C64 drives have ROM and RAM (memory) giving them
  1434.     the ability to run programs just like the C64 does.  Basically they are
  1435.     computers!  The C64 can transfer a program or send a command to the C64
  1436.     disk drive telling it to perform some internal action.  This action happens
  1437.     totally independent of the C64.  This ability is used for everything from
  1438.     reading drive errors to copy protection and FAST LOADERS.  Amiga drives on
  1439.     the other hand are not "intelligent devices."  They have no RAM or ROM and
  1440.     basically rely on the Amiga to perform all actions.  Because of this fact,
  1441.     Amiga drives will not work with most C64 copy protection and will not
  1442.     support any kind of communications meant for a C64 drive besides the simple
  1443.     reading and writing of programs and data.  If you try to perform some
  1444.     action with an Amiga drive that it can not handle an error requester will
  1445.     appear (See A64 ERRORS in the PROBLEMS AND SOLUTIONS section).  You can
  1446.     avoid these incompatibilities by using C64 disk drives whenever possible.
  1447.     A64 supports all communications with C64 disk drives and when using them
  1448.     these incompatibilities do not exist.
  1449.  
  1450.     NOTES: You can not do a directory of an Amiga disk from within A64. You
  1451.            must exit A64 to A64 Prefs and use the CLI to get the directory.
  1452.  
  1453.            Amiga drives will support reading and writing of the file types:
  1454.            PRG, SEQ and USR.  Relative (REL) files are not supported.  Please
  1455.            note that file types are not saved with the file on Amiga drives,
  1456.            but the file formats are identical to the C64's (PRG files include
  1457.            load address, SEQ and USR do not).
  1458.  
  1459.            In A64 V1.00n LOADING (reading) from Amiga drives is slow, even from
  1460.            RAM disks.  We do expect to dramatically increase the speed of LOADs
  1461.            in the future.
  1462.  
  1463.  
  1464.  
  1465.                                                                         3-10
  1466.  
  1467.  
  1468.  
  1469. -
  1470.  
  1471.  
  1472.  
  1473. THE GRAFIX MENU
  1474.  
  1475.  
  1476. COLORS
  1477.  
  1478.     KEY SEQUENCE: [LEFT AMIGA] [C] (Colors)
  1479.  
  1480.     The COLORS menu option allows you change A64's colors and the number of
  1481.     colors A64 uses to draw the C64's display.
  1482.  
  1483.     Before explaining the COLORS option we must first explain a little bit
  1484.     about the Commodore 64's colors and how it uses them.  The Commodore 64 is
  1485.     capable of displaying a maximum of 16 colors at any one time.  On the C64
  1486.     you are not able to change its colors, they are always displayed the same
  1487.     (Until now!).  The C64 uses numbers to signify its colors.  Seeing how
  1488.     there are 16 colors and computers start counting at 0, these color numbers
  1489.     range from 0 to 15.  The C64's color numbers and there corresponding colors
  1490.     are as follows:
  1491.  
  1492.     0 = BLACK    4 = PURPLE     8 = ORANGE    12 = MED GRAY
  1493.     1 = WHITE    5 = GREEN     9 = BROWN    13 = LGT GREEN
  1494.     2 = RED        6 = BLUE    10 = LGT RED    14 = LGT BLUE
  1495.     3 = CYAN    7 = YELLOW    11 = DARK GRAY    15 = LGT GRAY
  1496.  
  1497.     When selecting COLORS a screen will open at the bottom of the A64 Prefs
  1498.     screen.  This screen has many gadgets that allow you to control A64's
  1499.     colors.  The color screen's gadgets will be explained by separating them
  1500.     into sections.  Please note that most of the color screen's gadgets
  1501.     interact with each other.  If you change the setting of one gadget it will
  1502.     probably change the setting of one or more other gadgets, because of this
  1503.     we suggest that you read this section of the manual in order, without
  1504.     jumping from section to section.  The color screen's gadgets and their
  1505.     functions are as follows:
  1506.  
  1507. COLOR GADGETS
  1508.  
  1509.     The COLOR GADGETS are the 20 small gadgets that start at the top, left hand
  1510.     side of the screen. These gadgets represent A64's current color palette,
  1511.     with each gadget containing one of A64's colors.  These COLOR GADGETS allow
  1512.     you to select a color that you want to change.  The current selected gadget
  1513.     will be displayed with a red square around it.  You will note that there
  1514.     are 20 gadgets, while the C64 only has 16 colors.  This is because A64
  1515.     needs other colors, in addition to the C64's 16 colors, for some of it's
  1516.     COLOR MODES (COLOR MODES are discussed in the following sections).  To
  1517.     explain this we need to define what C64 colors are represented by each
  1518.     COLOR GADGET.  Going left to right, the first COLOR GADGET represents the
  1519.     C64's current background color.  The background color is the color of the
  1520.     screen that doesn't contains any graphics data, the transparent part of the
  1521.     screen.  For those of you that know a little about the C64's graphics, the
  1522.     background color is stored in the C64's color register at 53281.  The
  1523.     actual color this gadget contains depends on what COLOR MODE you are using.
  1524.     If you are using 16 or 20 COLOR MODE, this gadget will contain a mirror
  1525.     image of one of the C64's 16 colors (it will contain the same color as one
  1526.     of the other gadgets).  If you are using one of the other COLOR MODES: 2,
  1527.     4, or 8, then it will contain it's own independent color.  The next 16
  1528.     gadgets represent the C64's 16 colors, with the first gadget representing
  1529.     the C64's color 0 and the last gadget, of the 16, representing the C64's
  1530.  
  1531.                                                                         3-11
  1532.  
  1533.  
  1534.  
  1535. -
  1536.  
  1537.  
  1538.  
  1539.     color 15. The last three color gadgets are only used for A64's 20 COLOR
  1540.     MODE.  They represent three of the C64's color registers that are used for
  1541.     two of it's graphics modes.  For the people who know a little bit about the
  1542.     C64's graphics, the C64 color registers are at 53282-53284 and are used for
  1543.     multicolor text and extended background color text modes.  These three
  1544.     gadgets are like the background color gadget and will contain a mirror
  1545.     image of one of the C64's 16 colors.
  1546.  
  1547.     NOTES: The four gadgets described above, the background color gadget and
  1548.            the three gadgets used by 20 COLOR MODE, are different from the
  1549.            other 16 COLOR GADGETS.  While the other 16 COLOR GADGETS represent
  1550.            actual C64 colors that the C64 can not change, these four gadgets
  1551.            represent color registers within the C64 that can be changed to any
  1552.            one of its 16 colors.  Seeing how the C64 can change the color in
  1553.            these registers, thus changing the color in the gadgets that
  1554.            represent them, any changes you make to these gadgets will be
  1555.            temporary.  If you want to change one of these four gadgets and have
  1556.            its color preserved when A64 is re-entered you must find the other
  1557.            gadget (in the other 16 gadgets) that contains the same color as the
  1558.            gadget you want to change and then modify that gadget to the color
  1559.            you want.  For example, using the default C64 colors, the background
  1560.            color gadget will contain the color blue and will be a mirror image
  1561.            of the seventh COLOR GADGET, which will also contain the color blue.
  1562.            If you change the color of the seventh COLOR GADGET to white and
  1563.            then re-enter A64, the background color will be changed to white,
  1564.            the color you selected in the seventh COLOR GADGET.  If you had only
  1565.            changed the color in the background color gadget and re-entered A64
  1566.            the background color would be changed back to blue, the color in the
  1567.            seventh COLOR GADGET.
  1568.       
  1569.            When selecting a COLOR MODE of less than 20, all unused COLOR
  1570.            GADGETS will be disabled.
  1571.  
  1572. SLIDER GADGETS
  1573.  
  1574.     The SLIDER GADGETS are the three long, multicolored gadgets located below
  1575.     the COLOR GADGETS.  These gadgets are used to change A64's colors.  More
  1576.     specifically, they allow you to change the color contained in the selected
  1577.     COLOR GADGET.  On the Amiga, colors are formed by adding a combination of
  1578.     RED, GREEN and BLUE color parts.  These SLIDER GADGETS represent these
  1579.     three color parts with; RED on top, GREEN in the middle and BLUE on the
  1580.     bottom.  Each one of these gadgets contain 16 different colors.  By
  1581.     selecting one of these colors you will change the selected COLOR GADGET to
  1582.     that color.  You will note that every time you select a color that all the
  1583.     colors in the SLIDER GADGETS will change, this is to show what new colors
  1584.     are available within a certain range from the color you just selected.  All
  1585.     of the Amiga's 4096 possible colors can be achieved by changing the
  1586.     settings of these three gadgets.
  1587.  
  1588. COLOR MODE GADGET
  1589.  
  1590.     The COLOR MODE gadget is the located at the top, right hand side of the
  1591.     color screen.  It is shown by the words "COLOR MODE:" followed by a gadget
  1592.     containing a number.  This gadget allows you to pick how many colors A64
  1593.     will use to draw the C64 display.  The possible settings are: 2, 4, 8, 16
  1594.     and 20.  Each setting corresponds to the number of colors that A64 will
  1595.     use.  These color modes also relate to how many bitplanes are used to make
  1596.  
  1597.                                                                         3-12
  1598.  
  1599.  
  1600.  
  1601. -
  1602.  
  1603.  
  1604.  
  1605.     the C64 display.  The Amiga uses bitplanes to make up its screens (You do
  1606.     not need to fully understand bitplanes to grasp this example, but what you
  1607.     should understand is that the more bitplanes that are used, the more colors
  1608.     that can be displayed at one time and the more work A64 has to do to
  1609.     display them.  By lowering the number of bitplanes, we lower the number of
  1610.     available color, but also decrease the amount of work A64 has to do to draw
  1611.     the screen, resulting in A64 running faster). The following chart shows you
  1612.     how many colors the Amiga is capable of displaying for a certain number of
  1613.     bitplanes and how many colors A64 will display for the same number of
  1614.     bitplanes:
  1615.  
  1616.     NUMBER OF    NUMBER OF    NUMBER OF
  1617.     BITPLANES    AMIGA COLORS    A64 COLORS
  1618.     ---------    ------------    ----------
  1619.             1              2             2
  1620.             2              4             4
  1621.             3              8             8
  1622.             4             16             16
  1623.             5             32             20
  1624.  
  1625. 20 COLOR MODE
  1626.  
  1627.     There are only 16 colors on the C64, but because of differences in the way
  1628.     that the Amiga and the C64 make their screens A64 uses more than 16 colors
  1629.     to display all of the C64's colors.  In addition to the C64's 16 colors,
  1630.     A64 needs one color for the background color and it also uses three
  1631.     additional colors for two of its graphics modes (See COLOR GADGETS in the
  1632.     COLORS section).  That brings our total up to 20 colors needed for A64 to
  1633.     draw the C64's screen. That's how we get 20 COLOR MODE.  When using this
  1634.     COLOR MODE A64 can replicate the C64's screen perfectly.  The confusion
  1635.     starts when we start changing the COLOR MODE and lowering the number of
  1636.     bitplanes.  When we start lowering the COLOR MODE, we start losing colors.
  1637.     A64 handles this slightly different for 16 COLOR MODE than it does for the
  1638.     2, 4 & 8 COLOR MODES.  We will explain this by separating 16 COLOR MODE
  1639.     from the 2, 4 & 8 COLOR MODES and explaining them separately.
  1640.  
  1641. 16 COLOR MODE
  1642.  
  1643.     With 16 COLOR MODE A64 uses four bitplanes.  This allows us to have a 
  1644.     maximum of 16 colors, exactly the number the C64 has, but remember, A64
  1645.     needs other colors.  A64 needs a maximum of 20 colors and we now only have
  1646.     16, four colors short.  A64 handles this by replacing the missing colors
  1647.     with other available colors.  The first colors A64 can replace are the
  1648.     three colors mentioned above, that were needed for two of A64's graphics
  1649.     modes.  These three colors are only used for 20 COLOR MODE and can be
  1650.     ignored for all other COLOR MODES.  Getting rid of these three colors
  1651.     brings our total colors, needed by A64, down to 17.  This still leaves us
  1652.     with one color too many.  The way A64 handles this, is to replace one of
  1653.     the C64's colors.  A64 replaces the C64's color 15 (light gray) with the
  1654.     C64's color 1 (white).  This means, when using 16 COLOR MODE, whenever
  1655.     something is supposed to be displayed in color 15 it will be displayed in
  1656.     color 1.  This replacement was picked, because the default color 1 (white)
  1657.     looks very close to the default color 15 (light gray).  For all practical
  1658.     purposes, this is the only difference between 16 COLOR MODE and 20 COLOR
  1659.     MODE.  With 16 COLOR MODE all colors will look the way they should, except
  1660.     color 15 will be replaced with color 1.
  1661.  
  1662.  
  1663.                                                                         3-13
  1664.  
  1665.  
  1666.  
  1667. -
  1668.  
  1669.  
  1670.  
  1671. 2, 4 & 8 COLOR MODES
  1672.  
  1673.     The remaining three COLOR MODES: 2, 4 & 8, are all handled by A64 in the
  1674.     same way.  With these COLOR MODES A64 must replace more colors, the lower
  1675.     the color mode, the more colors that need to be replaced.  The way A64 does
  1676.     this is by taking the number of allowed colors (the COLOR MODE number) and
  1677.     reserving one color for the background color and using the remaining colors
  1678.     for the C64 colors.  Because of the limited number of colors provided by
  1679.     these COLOR MODES A64 sets aside one color for the background color that
  1680.     will be different than all the remaining colors, this is slightly different
  1681.     than the 20 & 16 color modes, where the background color is always a copy
  1682.     of one of the C64's colors. For example, in 8 COLOR MODE, A64 uses 1 color
  1683.     for the background color, leaving 7 colors free for C64 colors. In 4 COLOR
  1684.     MODE, A64 uses 1 color for the background color, leaving 3 colors free for
  1685.     C64 colors and in 2 COLOR MODE A64 uses 1 color for the background color,
  1686.     leaving 1 color free for C64 colors (this is the equivalent of a monochrome
  1687.     mode).  The following chart shows what colors are replaced by these COLOR
  1688.     MODES:
  1689.  
  1690.         The 2, 4 & 8 COLOR MODE numbers correspond to the COLOR GADGETS
  1691.         starting with the second gadget in, from the left (skip the 1st color
  1692.         gadget, the background color gadget). 
  1693.  
  1694.         C64 COLOR    8 COLOR MODE    4 COLOR MODE    2 COLOR MODE
  1695.         ---------    ------------    ------------    ------------
  1696.             0                1               1               1
  1697.             1                2               2               1
  1698.             2                3               3               1
  1699.             3                4               1               1
  1700.             4                5               2               1
  1701.             5                6               3               1
  1702.             6                7               1               1
  1703.             7                1               2               1
  1704.             8                2               3               1
  1705.             9                3               1               1
  1706.            10                4               2               1
  1707.            11                5               3               1
  1708.            12                6               1               1
  1709.            13                7               2               1
  1710.            14                1               3               1
  1711.            15                2               1               1
  1712.  
  1713.     The different COLOR MODES supported by A64 may seem very confusing, but
  1714.     they are really not that complicated once you start using them.  Included
  1715.     with The A64 package is a C64 program named "64Colors."  It is located in
  1716.     the directory "64Prgs."  We suggest you use this program and experiment
  1717.     with the different COLOR MODES to see their effect on the C64's colors.
  1718.  
  1719.     NOTES: Each COLOR MODE has its own color palette containing the number of
  1720.            colors supported by the COLOR MODE (i.e., 16 COLOR MODE has its own
  1721.            palette of 16 colors).  When changing COLOR MODES the new COLOR
  1722.            MODE's palette will be switched in and the previous palette, and any
  1723.            changes you made to it, will be preserved.  This is the same as if
  1724.            you had selected the OK gadget for the changes, so before changing
  1725.            COLOR MODES make sure any colors that you changed are they way you
  1726.            want them.
  1727.  
  1728.  
  1729.                                                                         3-14
  1730.  
  1731.  
  1732.  
  1733. -
  1734.  
  1735.  
  1736.  
  1737.            The drawing of the C64's screen is the most time consuming part of
  1738.            A64.  The general rule is that the more graphics a C64 program uses,
  1739.            the more work A64 has to do to display them and the slower A64 will
  1740.            run the C64 program.  You can help compensate for this extra work,
  1741.            by lowering the COLOR MODE.  When you lower the COLOR MODE you
  1742.            decrease the number of bitplanes that A64 has to draw to making A64
  1743.            run faster.  We strongly recommend that you lower the COLOR MODE to
  1744.            at least 16 whenever possible.  16 COLOR MODE will handle most C64
  1745.            programs with no dramatic decrease in color resolution.  Also note
  1746.            that if you are running an A1000 with 512k or an A500 or A2000 with
  1747.            1mb or less, selecting 16 COLOR MODE, which eliminates the 5th
  1748.            bitplane, will give you a more noticeable speed increase.
  1749.  
  1750. OK GADGET
  1751.  
  1752.     Selecting OK will preserve all changes to the COLORS settings. They will
  1753.     become the current COLORS settings and become active immediately.
  1754.  
  1755. CANCEL GADGET
  1756.  
  1757.     Selecting CANCEL will ignore all changes to the current COLORS settings in
  1758.     the current COLOR MODE and abort the procedure.  CANCEL will not cancel out
  1759.     changes to the COLOR MODE setting itself nor will it restore changes made
  1760.     to another COLOR MODES' colors.
  1761.  
  1762.     NOTES: When the A64 Colors screen is open the A64 Prefs screen will become
  1763.            "locked" and you will not be able to access any of A64 Prefs menus
  1764.            until you close the A64 Colors screen (when A64 Prefs screen is
  1765.            locked it will say "SCREEN LOCKED" on its title bar).
  1766.  
  1767.            A64 COLORS is still in the early stages of development.  Future
  1768.            versions of it will have many more features that you would expect
  1769.            from a color selection screen of this type (i.e., COPY, SWAP,
  1770.            SPREAD, etc.).  Also, the proportional gadgets response will be
  1771.            much faster (these are the sliding gadgets at the left of the screen
  1772.            that allow you to change colors).
  1773.  
  1774.  
  1775. BORDERS
  1776.  
  1777.     KEY SEQUENCE: None
  1778.  
  1779.     The BORDERS menu option allows you to toggle the C64's borders on and off.
  1780.     Because the Amiga does not support a true border around its screen, a
  1781.     border around the entire C64 screen can not be emulated efficiently.  To
  1782.     support programs that need borders, for such things as changing the border
  1783.     color to signify some status within the program, A64 supports a border on
  1784.     the top and bottom of the screen.  Changing the status of the borders will
  1785.     have no effect on the operation of A64, but may make some programs look
  1786.     better.
  1787.  
  1788.     The BORDERS menu option has two settings: ON and OFF.  You can select one
  1789.     or the other of these settings and selecting one automatically unselects
  1790.     the other.  The current selected setting is shown by displaying a checkmark
  1791.     next to it.  To turn the on borders, select ON, and to turn the borders
  1792.     off, select OFF.
  1793.  
  1794.     NOTE: The borders will not be visible until re-entering A64.
  1795.                                                                         3-15
  1796.  
  1797.  
  1798.  
  1799. -
  1800.  
  1801.  
  1802.  
  1803. SCREEN REFRESH
  1804.  
  1805.     KEY SEQUENCE: None
  1806.  
  1807.     The SCREEN REFRESH menu option allows to change the way A64 draws the C64
  1808.     screen.  A64 supports two ways of drawing the C64 screen, each having its
  1809.     own advantages and disadvantages.  The two ways A64 can draw the C64's
  1810.     screen are as follows:
  1811.  
  1812. DIRECT MODE
  1813.  
  1814.     When A64 is in DIRECT MODE it writes to the Amiga's screen directly.  This
  1815.     means, when the C64 is performing an operation that changes some part of
  1816.     the C64's screen A64 make the same change immediately to the Amiga's
  1817.     screen.  This way of drawing directly to the Amiga's screen has the
  1818.     advantage of showing changes of the C64's screen immediately resulting in
  1819.     smoother screen updates, but has the disadvantage of having the tendency
  1820.     to slow down A64 when alot of changes are happening to the C64's screen
  1821.     seemingly at one time. For example, scrolling in games.  DIRECT MODE is
  1822.     the default setting for the way A64 draws the screen and it is suggested
  1823.     that you use this setting for most C64 programs.
  1824.  
  1825. SAMPLE MODE
  1826.  
  1827.     When A64 is in SAMPLE MODE it draws the changes in the C64 screen at a set
  1828.     SAMPLE rate.  This means that A64 will SAMPLE the C64 graphics a couple of
  1829.     times per second to see what has changed and then draw the changes.  This
  1830.     way of drawing the screen, by taking samples of the C64 graphics, has the
  1831.     advantage of being faster when alot of changes are happening to the C64's
  1832.     screen seemingly at one time.  For example, scrolling in games, but has the
  1833.     disadvantage of making the screen updates appear jerky and at times out of
  1834.     sequence.  When using C64 programs that are real graphics intensive you can
  1835.     select SAMPLE MODE to make them run faster.
  1836.  
  1837.     The SCREEN REFRESH menu option has two settings: SAMPLE and DIRECT which
  1838.     represent the two modes described above.  You can select one or the other
  1839.     of these settings and selecting one automatically unselects the other.  The
  1840.     current selected setting is shown by displaying a checkmark next to it.
  1841.     Select SAMPLE for SAMPLE MODE and select DIRECT for DIRECT MODE.
  1842.  
  1843.     NOTE: There are times in A64 when SAMPLE MODE will override DIRECT MODE,
  1844.           because SAMPLE MODE can perform the screen updates more efficiently. 
  1845.           When you are running a C64 program that uses a graphics technique
  1846.           called "raster interrupts" and more than one graphics mode is used at
  1847.           one time SAMPLE MODE will automatically be selected, regardless of
  1848.           the menu option setting.
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861.                                                                         3-16
  1862.  
  1863.  
  1864.  
  1865. -
  1866.  
  1867.  
  1868.  
  1869. THE TOOLS MENU
  1870.  
  1871.  
  1872. SAVE SCREEN
  1873.  
  1874.     KEY SEQUENCE: [F1]
  1875.  
  1876.     The SAVE SCREEN menu option allows you to save the currently displayed C64
  1877.     screen as an IFF file.  After saving the screen you can then load it into
  1878.     any Amiga graphics program that supports IFF pictures, like Deluxe Paint.
  1879.  
  1880.     When selecting SAVE SCREEN you will be prompted with a requester asking you
  1881.     to enter the name of the file you wish to save the screen as.  Use the
  1882.     requester's string gadget to enter the name and then press the RETURN key
  1883.     to save the file.  You can also use the requester's other gadgets to select
  1884.     the following:
  1885.  
  1886.         OK, Save the screen. (Pressing RETURN does the same.)
  1887.  
  1888.         CANCEL, Abort the procedure.
  1889.  
  1890.     NOTE: The filename can contain any legal AmigaDOS path name, limited to 31
  1891.           characters in length.
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.  
  1924.  
  1925.  
  1926.  
  1927.                                                                         3-17
  1928.  
  1929.  
  1930.  
  1931. -
  1932.  
  1933.  
  1934.  
  1935. A64 PREFS NOTES
  1936.  
  1937.     This section contains miscellaneous information about A64 Prefs that did
  1938.     not fit into other sections of the manual.
  1939.  
  1940.     When in A64 Prefs you can press [F10] to toggle the title bar on and off.
  1941.  
  1942.     When A64 is running some programs and you bring up A64 Prefs, you may
  1943.     notice some images disappear from the C64 screen, this is normal. These
  1944.     images are called "sprites."  Sprites are independent graphics images and
  1945.     not part of the screen in the normal sense.  Because A64 Prefs does not
  1946.     support C64 sprites, they will disappear from the screen when it is
  1947.     entered.  An example of a sprite is the Amiga's mouse pointer.
  1948.  
  1949.     When A64 is running some programs and you bring up A64 Prefs, you may
  1950.     notice the background changes color, this is normal.  This can happen if a
  1951.     C64 program is using a graphics technique called "raster interrupts" and
  1952.     the background color is different in areas on the same screen.  Because A64
  1953.     Prefs does not support multiple background colors on the same screen, as
  1954.     A64 does, it will display the last background color used for its background
  1955.     color.
  1956.  
  1957.     You should never attempt to bring up A64 Prefs while I/O (INPUT/OUTPUT) is
  1958.     in progress.  This means that whenever A64 is loading or saving from a disk
  1959.     drive, accessing a modem or using a printer, you should wait until the
  1960.     operation is completed before bringing up A64 Prefs.  This warning should
  1961.     especially be noted when accessing C64 devices.  Bringing up A64 during
  1962.     I/O should not "crash" A64, but may result in a "C64 crash" forcing you to
  1963.     reset A64 and/or the C64 devices that you interrupted.  To be on the safe
  1964.     side you should heed this warning.
  1965.  
  1966.     If at anytime you try to bring up A64 Prefs and the title bar does not
  1967.     appear and/or the screen goes blank this means A64 Prefs has not yet been
  1968.     entered correctly.  The most likely cause of this is the Amiga has brought
  1969.     up a  system requester on the WorkBench screen.  You must clear this
  1970.     requester before A64 Prefs will be entered correctly.  To do this, follow
  1971.     this procedure:
  1972.  
  1973.         1. Use the following key sequence to get access to the WorkBench
  1974.            screen:
  1975.  
  1976.                [LEFT AMIGA] [N]: Send Workbench to front, A64 Prefs to back
  1977.  
  1978.         2. Perform the action requested by the requester or select CANCEL.
  1979.         3. If A64 Prefs does not appear automatically after handling the
  1980.             requester use the following key sequence or depth arrange the
  1981.             WorkBench screen to get to A64 Prefs:
  1982.  
  1983.                [LEFT AMIGA] [M]: Send Workbench to back, A64 Prefs to front
  1984.  
  1985.         NOTE: If there is not a system requester on the WorkBench screen then
  1986.               A64 is stuck somewhere and you will have to reboot your Amiga to
  1987.               get everything back to normal.  Every precaution has been taken
  1988.               to make sure this doesn't happen.
  1989.  
  1990.  
  1991.  
  1992.  
  1993.                                                                         3-18
  1994.  
  1995.  
  1996.  
  1997. -
  1998.  
  1999.  
  2000.  
  2001. UTILITIES
  2002.  
  2003.     The A64 Package comes with a number of utility programs serving a variety
  2004.     of functions.  The majority of these utility programs are for helping with
  2005.     the transfer of C64 programs and data to the Amiga.  These utilities allow
  2006.     you to access C64 disk drives and printers directly from AmigaDOS and most
  2007.     of them must be run from the CLI.  In the following sections we will
  2008.     outline each utility and how to use it. 
  2009.  
  2010.  
  2011. UTILITIES SUMMARY
  2012.  
  2013.     The following list gives a brief summary of the utilities included with
  2014.     The A64 Package.  A couple of the headings need explanation.  The heading
  2015.     HDW is short for HarDWare interface and is used to signify if the utility
  2016.     directly needs A64's hardware interface.  The heading ENV is short for
  2017.     ENVironment and is used to state what environment the utility is to be used
  2018.     in.  The different environments are: WB - the utility is meant to be used
  2019.     with the WorkBench, but can also be used from the CLI, CLI - the utility
  2020.     is used from the CLI only, C64 - the utility is meant to be used on the
  2021.     C64, and A64 - the utility can be used by both A64 and the C64.  Please
  2022.     note that the utilities with their environment set to C64 or A64 are
  2023.     actual Commodore 64 programs, all other utilities are Amiga programs. Also
  2024.     note that just because a utility does not use the hardware interface
  2025.     directly does not mean that the utility will be useful without it.  For
  2026.     example the utility "Pet2ASCII" will convert a file from PetASCII to ASCII,
  2027.     but to use it you must first transfer a C64 program to an Amiga disk.
  2028.  
  2029.     UTILITY NAME    HDW    ENV    FUNCTION
  2030.     ------------    ---    ---    --------
  2031.     64Cmd        YES    CLI    Send a command to a C64 drive
  2032.     64Dir        YES    CLI    Read the dir of a C64 drive
  2033.     64Print        YES    CLI    Print an Amiga file to a C64 printer
  2034.     64Status            YES    CLI    Read a C64 drives' status
  2035.     64ToAmiga            YES    CLI    Copy a file from a C64 drive to an
  2036.                                         Amiga drive
  2037.     AmigaTo64            YES    CLI    Copy a file from an Amiga drive to a
  2038.                                         C64 drive
  2039.     InstallA64Font    NO    WB    Install A64's font to FONTS:
  2040.     Pet2ASCII            NO    CLI    Convert a file from PetASCII to ASCII
  2041.     PrintFile            NO    WB    Print an Amiga file to an Amiga printer
  2042.     StripLoadAddr    NO    CLI    Strip the load address from a file
  2043.  
  2044.     64Colors            NO    A64    View the C64's colors
  2045.     SaveROMs            NO    C64    Save the C64's ROMs
  2046.  
  2047.  
  2048. CONVENTIONS FOR THE CLI BASED UTILITIES
  2049.  
  2050.     Here are some general conventions for using the CLI based utilities that
  2051.     will help make them easier to use:
  2052.  
  2053.     For all the CLI based utilities except one, 64Status, you may enter the
  2054.     utilities name alone to get it's usage (for 64Status enter ? after its name
  2055.     to get its usage).
  2056.  
  2057.         For example, if you type: 64ToAmiga [RETURN]
  2058.  
  2059.                                                                         4-1
  2060.  
  2061.  
  2062.  
  2063. -
  2064.  
  2065.  
  2066.  
  2067.         The utility will print a short copyright message followed by a usage
  2068.         line that shows the syntax of the input that the utility expects.  A
  2069.         usage line appears like this:    
  2070.  
  2071.         Usage: 64ToAmiga <source filename> <destination filename> [file type]
  2072.  
  2073.     A utilities usage line shows what parameters are needed by the utility and
  2074.     incloses these parameters with symbols:
  2075.  
  2076.         When you see a parameter inclosed in < > this parameter is required by
  2077.         the utility and must be entered for the utility to function properly.
  2078.  
  2079.         When you see a parameter inclosed in [ ] this parameter is optional. If
  2080.         you don't enter anything for this parameter the utility will use some
  2081.         default value for it.
  2082.  
  2083.     NOTE: When using the CLI commands that require A64's hardware interface
  2084.           you should make sure the interface and the correct device for the
  2085.           utility is connected before attempting to use the utility.  Failing
  2086.           to do this can lock-up your Amiga.
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.  
  2120.  
  2121.  
  2122.  
  2123.  
  2124.  
  2125.                                                                         4-2
  2126.  
  2127.  
  2128.  
  2129. -
  2130.  
  2131.  
  2132.  
  2133. 64Cmd
  2134.  
  2135.     PURPOSE:     Send a command to a C64 disk drive
  2136.  
  2137.     USAGE:       64Cmd <command string> [drive]
  2138.                      <command string> is a valid C64 drive command string.
  2139.                      [drive] is a C64 drive, specified as df8:, df9:, df10: or
  2140.                          df11:.  df8: is the default.
  2141.  
  2142.     ENVIRONMENT: CLI
  2143.  
  2144.     INTERFACE:   YES
  2145.  
  2146.     64Cmd will allow you to send a command to a C64 disk drive.  It supports
  2147.     all of the standard Commodore DOS commands.  Some examples of using 64Cmd
  2148.     are:
  2149.  
  2150.         FORMAT:   Format a disk
  2151.         USAGE:    64Cmd N0:<disk name>,<2 digit id> [C64 drive]
  2152.         EXAMPLE:  64Cmd N0:testdisk,64 df8:
  2153.  
  2154.         SCRATCH:  Delete a file
  2155.         USAGE:    64Cmd S0:<filename> [C64 drive]
  2156.         EXAMPLE:  64Cmd S0:testfile df8:
  2157.  
  2158.         RENAME:   Rename a file
  2159.         USAGE:    64Cmd R0:<new name>=<old name> [C64 drive]
  2160.         EXAMPLE:  64Cmd R0:testfile2=testfile1 df8:
  2161.  
  2162.     For more information on C64 drive commands see your 1541 disk drive user's
  2163.     manual.
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.  
  2188.  
  2189.  
  2190.  
  2191.                                                                         4-3
  2192.  
  2193.  
  2194.  
  2195. -
  2196.  
  2197.  
  2198.  
  2199. 64Dir
  2200.  
  2201.     PURPOSE:     Get a directory listing of a C64 disk
  2202.  
  2203.     USAGE:       64Dir <search string> [drive]
  2204.                      <search string> is a valid C64 search string.
  2205.                      [drive] is a C64 drive, specified as df8:, df9:, df10: or
  2206.                          df11:.  df8: is the default.
  2207.  
  2208.     ENVIRONMENT: CLI
  2209.  
  2210.     INTERFACE:   YES
  2211.  
  2212.     64Dir will allow you to get a directory of a C64 disk. Some examples of
  2213.     using 64Dir are:
  2214.  
  2215.          64Dir $ df8:
  2216.  
  2217.         Will list the entire directory of drive 8.
  2218.  
  2219.          64Dir $:a* df9:
  2220.  
  2221.             Will list only the files that begin with "a" on drive 9.
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.  
  2257.                                                                         4-4
  2258.  
  2259.  
  2260.  
  2261. -
  2262.  
  2263.  
  2264.  
  2265. 64Print
  2266.  
  2267.     PURPOSE:     Print a file to C64 printer
  2268.  
  2269.     USAGE:       64Print <filename> <device> [option]
  2270.                      <filename> is the name of the file you wish to print.
  2271.                      <device> is a C64 printer number, either 4 or 5.  The
  2272.                          default is 4.
  2273.                      [option] can be either A for ASCII or B for Binary The
  2274.                          default is A.  The difference between these options
  2275.                          is that A will convert the file from ASCII to
  2276.                          PetASCII before printing it and B will not do any
  2277.                          conversion of the file.
  2278.  
  2279.     ENVIRONMENT: CLI
  2280.  
  2281.     INTERFACE:   YES
  2282.  
  2283.     64Print will allow you to print a file to a C64 printer.  Some examples of
  2284.     using 64Print are:
  2285.  
  2286.          64Print testfile
  2287.  
  2288.                  Will print the file "testfile"
  2289.  
  2290.          64Print testfile2 B
  2291.  
  2292.             Will print the file "testfile2" without any ASCII conversions.
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319.  
  2320.  
  2321.  
  2322.  
  2323.                                                                         4-5
  2324.  
  2325.  
  2326.  
  2327. -
  2328.  
  2329.  
  2330.  
  2331. 64Status
  2332.  
  2333.     PURPOSE:     Read a the status of a C64 disk drive
  2334.  
  2335.     USAGE:       64Status [drive]
  2336.                      [drive] is a C64 drive, specified as df8:, df9:, df10: or
  2337.                          df11:.  df8: is the default.
  2338.  
  2339.     ENVIRONMENT: CLI
  2340.  
  2341.     INTERFACE:   YES
  2342.  
  2343.     64Status allows you to read the status of a C64 disk drive.  When a C64
  2344.     drive encounters an error it will flash its read light off and on.  You
  2345.     can use 64Status to find out what caused the error.  An example of 64Status
  2346.     is:
  2347.  
  2348.         64Status df8:
  2349.  
  2350.             Will read the status of drive 8.
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.  
  2385.  
  2386.  
  2387.  
  2388.  
  2389.                                                                         4-5
  2390.  
  2391.  
  2392.  
  2393. -
  2394.  
  2395.  
  2396.  
  2397. 64ToAmiga
  2398.  
  2399.     PURPOSE:     Copy a file from a C64 drive to an Amiga drive.
  2400.  
  2401.     USAGE:       64ToAmiga <source filename> <destination filename> [file type]
  2402.                      <source filename> is a C64 filename.
  2403.                      <destination filename> is an Amiga filename.
  2404.                      [file type] can be either P for PRG file or S for SEQ
  2405.                          file.  The default is P.
  2406.  
  2407.     ENVIRONMENT: CLI
  2408.  
  2409.     INTERFACE:   YES
  2410.  
  2411.         64ToAmiga will allow you to copy a file from a C64 disk drive to an
  2412.         Amiga disk drive.  Some examples of using 64ToAmiga are:
  2413.  
  2414.             64ToAmiga df8:testfile df0:
  2415.  
  2416.         Will copy the file "testfile" from the C64 drive 8 to the Amiga
  2417.                 drive 0.
  2418.  
  2419.             64ToAmiga df8:testfile2 df0:64Prgs/testfile S
  2420.  
  2421.                 Will copy the sequential file "testfile2" from the C64 drive 8
  2422.                 to the file "testfile" in the directory 64Prgs on Amiga drive
  2423.                 0.
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.  
  2450.  
  2451.  
  2452.  
  2453.  
  2454.  
  2455.                                                                         4-7
  2456.  
  2457.  
  2458.  
  2459. -
  2460.  
  2461.  
  2462.  
  2463. AmigaTo64
  2464.  
  2465.     PURPOSE:     Copy a file from an Amiga drive to a C64 drive.
  2466.  
  2467.     USAGE:       AmigaTo64 <source filename> <destination filename> [file type]
  2468.                      <source filename> is an Amiga filename.
  2469.                      <destination filename> is a C64 filename.
  2470.                      [file type] can be either P for PRG file or S for SEQ
  2471.                          file.  The default is P.
  2472.  
  2473.     ENVIRONMENT: CLI
  2474.  
  2475.     INTERFACE:   YES
  2476.  
  2477.         AmigaTo64 will allow you to copy a file from an Amiga disk drive to a
  2478.         C64 disk drive.  Some examples of using AmigaTo64 are:
  2479.  
  2480.             AmigaTo64 df0:testfile df8:
  2481.  
  2482.         Will copy the file "testfile" from the Amiga drive 0 to the C64
  2483.                 drive 8.
  2484.  
  2485.             AmigaTo64 df0:64Prgs/testfile df8:testfile2 S
  2486.  
  2487.                 Will copy the sequential file "testfile" from the directory
  2488.                 64Prgs on the Amiga drive 0 to the file "testfile2" on the C64
  2489.                 drive 8.
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.  
  2516.  
  2517.  
  2518.  
  2519.  
  2520.  
  2521.                                                                         4-8
  2522.  
  2523.  
  2524.  
  2525. -
  2526.  
  2527.  
  2528.  
  2529. InstallA64Font
  2530.  
  2531.     PURPOSE:     Install the A64 Font to FONTS:
  2532.  
  2533.     USAGE:       InstallA64Font
  2534.  
  2535.     ENVIRONMENT: WorkBench or CLI
  2536.  
  2537.     INTERFACE:   NO
  2538.  
  2539.     Install A64 Font will allow you to install the A64 font to the current
  2540.     FONTS: directory.  This font is needed by A64 and it must be installed on
  2541.     any WorkBench disk that you use with A64.
  2542.  
  2543.     To run InstallA64Font from the WorkBench follow this procedure:
  2544.  
  2545.         1. Double-click the InstallA64Font icon.
  2546.         2. A window will appear asking you to enter the name of the drive
  2547.            containing The A64 Package.  When this window appears enter the
  2548.            drive name and press RETURN.  For example, if the disk containing
  2549.            The A64 Package is in drive 0, enter: df0: [RETURN].
  2550.  
  2551.     The font will then be installed to the fonts directory on your WorkBench
  2552.     disk.
  2553.  
  2554.     See RUNNING A64 in the GETTING STARTED section for more information.
  2555.  
  2556.         
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.                                                                         4-9
  2588.  
  2589.  
  2590.  
  2591. -
  2592.  
  2593.  
  2594.  
  2595. Pet2ASCII
  2596.  
  2597.     PURPOSE:     Convert a file from PetASCII to ASCII.
  2598.  
  2599.     USAGE:       Pet2ASCII <source filename> [destination filename]
  2600.                      <source filename> is the name of the file you want to
  2601.                          convert
  2602.                      [destination filename] is the name of the file you want
  2603.                          to output the converted file to.  If not specified then
  2604.                          <source filename> will be overwritten by the converted
  2605.                          file.
  2606.  
  2607.     ENVIRONMENT: CLI
  2608.  
  2609.     INTERFACE:   NO
  2610.  
  2611.     Pet2ASCII will allow you to convert a file from PetASCII to standard ASCII.
  2612.     The C64 does not use standard ASCII.  "ASCII" stands for "American Standard
  2613.     Code for Information Interchange" and is a standardized method for the way
  2614.     that many computers represent certain information, namely english text. 
  2615.     This manual was written on an Amiga which uses ASCII codes to represent
  2616.     each letter and symbol.  The C64 has it's own form of ASCII called
  2617.     PetASCII.  The Commodore 64's PetASCII is quite a bit different from
  2618.     standard ASCII and for the Amiga to represent it correctly it must be
  2619.     converted to standard ASCII.
  2620.  
  2621.     Some examples of Pet2ASCII's usage are as follows:
  2622.  
  2623.         Pet2ASCII testfile
  2624.  
  2625.         Will covert the file "testfile" from PetASCII to ASCII.
  2626.  
  2627.         Pet2ASCII testfile testfile.asc
  2628.  
  2629.         Will covert the file "testfile" from PetASCII to ASCII, leaving
  2630.                 file "testfile" unchanged and the converted file in
  2631.                 "testfile.asc".
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.  
  2648.  
  2649.  
  2650.  
  2651.  
  2652.  
  2653.                                                                         4-10
  2654.  
  2655.  
  2656.  
  2657. -
  2658.  
  2659.  
  2660.  
  2661. PrintFile
  2662.  
  2663.     PURPOSE:     Print a file
  2664.  
  2665.     USAGE:       PrintFile [filename]
  2666.  
  2667.     ENVIRONMENT: WorkBench or CLI
  2668.  
  2669.     INTERFACE:   NO
  2670.  
  2671.     PrintFile will allow you to print a file to an Amiga printer.  It can be
  2672.     used from either the CLI or the WorkBench.  To use it from the WorkBench
  2673.     double-click its icon and then enter the name of the file you wish to
  2674.     print.  After entering the filename press the RETURN key to print the file.
  2675.     You can also pass PrintFile a filename by selecting a document icon and
  2676.     holding down one of the SHIFT keys while double-clicking the PrintFile
  2677.     icon.  For example if you want to print the file "ReadMe":
  2678.  
  2679.         1. Select the ReadMe icon by clicking the left mouse button on it once.
  2680.         2. Press one of the shift keys on the Amiga keyboard.
  2681.         3. Double-click the PrintFile icon while still holding down the shift
  2682.            key.
  2683.  
  2684.     PrintFile will then be started and automatically start printing the file
  2685.     "ReadMe."
  2686.  
  2687.     To run PrintFile from the CLI enter the following:
  2688.  
  2689.         PrintFile [filename]
  2690.  
  2691.     PrintFile will then be started and automatically start printing the file
  2692.     you specified.
  2693.  
  2694.     When PrintFile is done printing a file it does not close itself.  This
  2695.     allows you to print multiple files without restarting it.  To quit
  2696.     PrintFile select the close gadget at the top left hand corner of its window.
  2697.  
  2698.  
  2699.         
  2700.  
  2701.  
  2702.  
  2703.  
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  
  2711.  
  2712.  
  2713.  
  2714.  
  2715.  
  2716.  
  2717.  
  2718.  
  2719.                                                                         4-11
  2720.  
  2721.  
  2722.  
  2723. -
  2724.  
  2725.  
  2726.  
  2727. StripLoadAddr
  2728.  
  2729.     PURPOSE:     Strip a C64 load address from a file
  2730.  
  2731.     USAGE:       StripLoadAddr <filename>
  2732.                      <filename> is the name of the file you want to strip the
  2733.                          load address from.
  2734.  
  2735.     ENVIRONMENT: CLI
  2736.  
  2737.     INTERFACE:   NO
  2738.  
  2739.     StripLoadAddr will allow you to strip a load address from a C64 file.  The
  2740.     C64 adds a two byte load address to the start of its PRG files that tells
  2741.     it where to load the file.  When transferring these files to the Amiga
  2742.     you may wish to strip this load address.  An example of using StripLoadAddr 
  2743.     is:
  2744.  
  2745.         StripLoadAddr testfile
  2746.  
  2747.         Will strip the load address from the file "testfile."
  2748.  
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.  
  2770.  
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  
  2777.  
  2778.  
  2779.  
  2780.  
  2781.  
  2782.  
  2783.  
  2784.  
  2785.                                                                         4-12
  2786.  
  2787.  
  2788.  
  2789. -
  2790.  
  2791.  
  2792.  
  2793. C64 PROGRAMS
  2794.  
  2795.     The A64 Package comes with a couple of Commodore 64 programs, located in
  2796.     the directory 64Prgs.  These programs are as follows:
  2797.  
  2798.  
  2799. SaveROMs
  2800.  
  2801.     SaveROMs is for saving the C64 ROMs to disk.  It is meant to be run on a
  2802.     C64 because A64 does not contain the C64's ROMs.  To use this program
  2803.     see INSTALLING THE C64's ROMs in the TECHNICAL section.
  2804.  
  2805.  
  2806. 64Colors
  2807.  
  2808.     64Colors is a simple BASIC program that allows you to view the C64 colors.
  2809.     It was included with The A64 Package so you could experiment with A64's
  2810.     COLOR MODES while using it (See COLORS in the A64Prefs section).
  2811.  
  2812.     For information on how to load and run this program see DRIVES in the
  2813.     SYSTEM MENU section.
  2814.  
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.  
  2834.  
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.  
  2846.  
  2847.  
  2848.  
  2849.  
  2850.  
  2851.                                                                         4-13
  2852.  
  2853.  
  2854.  
  2855. -
  2856.  
  2857.  
  2858.  
  2859. TECHNICAL
  2860.  
  2861.  
  2862.  
  2863. THE A64 PACKAGES FILE STRUCTURE
  2864.  
  2865.     The A64 Package is very large and fills over 70% of 3.5" floppy disk,
  2866.     because of this, the entire package will not fit on a WorkBench disk.  Some
  2867.     users may wish to fit parts of The A64 PAckage onto a WorkBench disk,
  2868.     especially if they only have one disk drive.  This can be done by
  2869.     separating A64 from the rest of The A64 Package.  Please note that if you
  2870.     do separate The A64 Package into different parts you may not distribute
  2871.     them.  The A64 Package may only be distributed in its entirety.
  2872.  
  2873.     We are not going to discuss the exact details of how to extract parts of
  2874.     The A64 Package, but what we will do is tell you what directories and files
  2875.     are needed to run just A64.  Listed below is a directory listing of The
  2876.     A64 Package.  Directories and Files that appear with an "*" before their
  2877.     name must appear as listed for A64 to run.  All other files may be moved
  2878.     or removed.  Please note that the "*" is not part of the name of the
  2879.     directories and files and appears only to show what should stay as listed.
  2880.     Please note that if you want to have the ability to install the A64 Font
  2881.     onto a WorkBench disk you will need the files marked with "#".  Again, this
  2882.     symbol is not part of the names, but is used to signify them.
  2883.  
  2884.     *TheA64Package
  2885.          A64Utilities (dir)
  2886.            !.info                           .info
  2887.            64Cmd                            64Dir
  2888.            64Print                          64Status
  2889.            64ToAmiga                        AmigaTo64
  2890.            Pet2ASCII                        StripLoadAddr
  2891.          64Prgs (dir)
  2892.            64Colors                         SaveROMs
  2893.         #Fonts (dir)
  2894.              #A64 (dir)
  2895.                #6                                
  2896.           #A64.font                         
  2897.         *64Fonts (dir)
  2898.           *CharROM.64font                   
  2899.       .info                           *A64
  2900.      *A64.config                      *A64.info
  2901.       A64Utilities.info               *BASIC.data
  2902.       InitA64                         #InstallA64Font
  2903.      #InstallA64Font.info             *KERNAL.data
  2904.      *Lic                              Manual
  2905.       Manual.info                      PrintFile
  2906.       PrintFile.info                   ReadMe
  2907.       ReadMe.info                      Registration.form
  2908.       Registration.form.info          *ROM
  2909.      *Title                            
  2910.     *TheA64Package.info
  2911.  
  2912.  
  2913.  
  2914.  
  2915.  
  2916.  
  2917.                                                                         5-1
  2918.  
  2919.  
  2920.  
  2921. -
  2922.  
  2923.  
  2924.  
  2925. THE KEYBOARD
  2926.  
  2927.  
  2928. KEYBOARD DIFFERENCES
  2929.  
  2930.     There are some minor differences between the C64 keyboard and the Amiga's.
  2931.     The way A64 maps the keyboard is pretty much "what you see is what you
  2932.     get."  In most cases the legends on the keys represent their equivalent
  2933.     function.
  2934.  
  2935.     The exceptions to this are:
  2936.  
  2937.         AMIGA KEY            C64 EQUIVALENT
  2938.         ---------            --------------
  2939.         ESC                RUN/STOP
  2940.         BACKSPACE (BACKARROW)        CLR/HOME
  2941.         HELP                RESTORE
  2942.         LEFT AMIGA            COMMODORE
  2943.         `~                BACK ARROW
  2944.         \|                LYRA
  2945.         [{                [ (when shifted gives PI)
  2946.         ]}                ] (when shifted gives shift @)
  2947.  
  2948.     NOTE: The key sequence [RUN/STOP] [RESTORE] that is used to stop C64 BASIC
  2949.           programs, can be done by pressing [ESC] [HELP].
  2950.  
  2951. A PROBLEM WITH THE KEYBOARD
  2952.  
  2953.     Because of differences in a small number of keys on the keyboards of the
  2954.     C64 and the Amiga, a minor problem can occur with certain key sequences.
  2955.     This problem is rare and under normal typing situations should not be
  2956.     apparent.  It is related to pressing one or more of the shift keys and
  2957.     one of the numeric or punctuation keys simultaneously.  What will happen
  2958.     is that A64 will think you pressed a key that you didn't and an unwanted
  2959.     character will appear on the screen.  If this happens use the DEL key to
  2960.     delete the unwanted character.  Please note that this is not a "BUG" in
  2961.     A64, but is related to the way that the C64 reads the keyboard.
  2962.  
  2963. THE NUMERIC KEYPAD
  2964.  
  2965.     The numeric keypad on the Amiga keyboard is fully supported.  It should be
  2966.     noted that shifting the keys on the keypad will give the C64 equivalent and
  2967.     not the Amiga's equivalent.
  2968.  
  2969.     For example, using the key sequence: [SHIFT] [2]
  2970.  
  2971.     On the Amiga: [SHIFT] [2] (2 key at top left of keyboard) produces the '@'
  2972.                   [SHIFT] [2] (2 key on the numeric keypad) produces the '"'
  2973.  
  2974.     On the C64:   [SHIFT] [2] produces the '"'
  2975.  
  2976.     NOTE: By using the numeric keypad and it's C64 shifted equivalents you will
  2977.           eliminate most of the keys that can cause the problem listed above. 
  2978.  
  2979.  
  2980.  
  2981.  
  2982.  
  2983.                                                                         5-2
  2984.  
  2985.  
  2986.  
  2987. -
  2988.  
  2989.  
  2990.  
  2991. UNUSED KEYS
  2992.  
  2993.     There are a few of keys on the Amiga keyboard that are unused by A64.  They
  2994.     are as follows: TAB, F9, F10 and RIGHT AMIGA.  Also, when pressed
  2995.     simultaneously the two ALT keys will invoke A64 Prefs, but have no meaning
  2996.     when pressed by themselves.
  2997.  
  2998.  
  2999.  
  3000.  
  3001.  
  3002.  
  3003.  
  3004.  
  3005.  
  3006.  
  3007.  
  3008.  
  3009.  
  3010.  
  3011.  
  3012.  
  3013.  
  3014.  
  3015.  
  3016.  
  3017.  
  3018.  
  3019.  
  3020.  
  3021.  
  3022.  
  3023.  
  3024.  
  3025.  
  3026.  
  3027.  
  3028.  
  3029.  
  3030.  
  3031.  
  3032.  
  3033.  
  3034.  
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040.  
  3041.  
  3042.  
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.  
  3049.                                                                         5-3
  3050.  
  3051.  
  3052.  
  3053. -
  3054.  
  3055.  
  3056.  
  3057. A64 AND MULTITASKING
  3058.  
  3059.     A64 is the first true multitasking Commodore 64 emulator.  A64's
  3060.     multitasking ability gives it power and flexibility and allows it to be a
  3061.     stable and reliable program (Multitasking programs are MUCH easier to debug
  3062.     and improve than programs that take over your Amiga).  We hope you'll agree
  3063.     with us when we say "it's A64's multitasking ability that sets it apart
  3064.     from the other C64 emulators."
  3065.  
  3066.     Until now, everyone thought a program like a C64 emulator had to take over
  3067.     your Amiga, because it needs to run as fast as possible and needs system
  3068.     resources that the Amiga's operating system usually uses.  A64 manages to
  3069.     run faster than the other C64 emulators, use all the Amiga resources it
  3070.     needs and still leave the Amiga's operating system intact.  We can not even
  3071.     begin to explain what went into getting A64 to accomplish this amazing
  3072.     feat.  What we can say is that A64 should work just fine with any program
  3073.     that follows the rules of multitasking programming on the Amiga.  There have
  3074.     been times that we forgot that we were running A64 because we exited back
  3075.     to the WorkBench or the CLI to do something else and then after hours of
  3076.     running other programs we remembered that A64 was still in memory and we
  3077.     went back to it and found it working perfectly.  The only programs that A64
  3078.     may not work with are programs that take over, some part of or all of, your
  3079.     Amiga, like some games and other emulators.  Which brings up to our next
  3080.     point.  A64 can not multitask itself.  Even though A64 is capable of
  3081.     multitasking it still takes over system resources that can not be shared
  3082.     with other programs, so one copy of A64 can not share these resources with
  3083.     another copy of A64.
  3084.  
  3085.  
  3086. A64 AND MEMORY
  3087.  
  3088.     A64 is a very memory hungry program and in its full capacity it will take
  3089.     up over 300k of your Amiga's memory.  If your Amiga has less than 1mb of
  3090.     RAM, more likely than not, A64 will not run.  There are some things that
  3091.     users with 512k can do to get A64 to work.  If they install the C64's ROMs
  3092.     (See INSTALLING THE C64's ROMs in the TECHNICAL section) they can save
  3093.     about 135k of RAM, but doing this will greatly decrease A64's speed. 
  3094.     Please note that it is not the installation of the C64's ROMs that slows
  3095.     down A64, but rather the fact that 512k users do not have enough RAM to use
  3096.     A64's ROM emulation, which runs dramatically faster than the C64's ROMs
  3097.     by themselves.  Users with 1mb or more can install the C64's ROMs with no
  3098.     decrease in speed, just added compatibility.  Other things can also be done
  3099.     to save memory, like: make sure there are no other programs running, don't
  3100.     load the WorkBench and remove all external drives.  None of these options
  3101.     are really desireable and for that reason we recommend at least 1mb of RAM
  3102.     when using A64.
  3103.  
  3104.     Different memory configurations can make a dramatic difference in the speed
  3105.     of A64.  The worst case is running A64 on a 512k RAM system and the best
  3106.     case is running A64 on a 68020 based system with 32 bit RAM.  On a 68020
  3107.     based system speeds of well over 100% can be reached (We have not yet been
  3108.     able to try A64 on a 68030 based system, but we estimate speeds of around
  3109.     200% for some programs.  See 680x0 SUPPORT in the TECHNICAL section).  We
  3110.     normally recommend at least 1mb of RAM no matter how your Amiga is
  3111.     configured and this statement can be elaborated.  If you are running A64
  3112.     on an Amiga 1000 we recommend at least 1mb of RAM.  If you are running A64
  3113.     on an A500 or A2000 we recommend at least 1.5mb.  The reason for this
  3114.  
  3115.                                                                         5-4
  3116.  
  3117.  
  3118.  
  3119. -
  3120.  
  3121.  
  3122.  
  3123.     difference is not because A64 will not run on A500s or A2000s with only
  3124.     1mb, it's because A64 will run faster if these machines have more than 1mb.
  3125.     This is because A500's and A2000's with only 1mb don't have what is called
  3126.     FAST RAM.  This is RAM that can not be used by graphics and as a result
  3127.     programs run faster when using it.  We also recommend running the program
  3128.     "FastMemFirst," found in the System drawer of the V1.3 WorkBench, before
  3129.     running A64.  This program will force A64 (and other programs) to use this
  3130.     FASTer memory first.
  3131.  
  3132.  
  3133. 680x0 SUPPORT
  3134.  
  3135.     Basically most of the programs in this release of The A64 Package were
  3136.     designed to work with the 68000 microprocessor only.  The utility programs
  3137.     that use A64's hardware interface can be made to work with any
  3138.     microprocessor as long as if a 68020 is used its cache is turned off.  All
  3139.     other utilities will work with any microprocessor.  A64 itself can NOT be
  3140.     made to run with other microprocessors.  It does a check of the installed
  3141.     microprocessor and will not run if the wrong one is installed.  We
  3142.     currently have a separate version of A64 that runs with 68010 and 68020
  3143.     microprocessors and it is VERY impressive.  We are working on having just
  3144.     one version of A64 that will work with ALL the 680x0 microprocessors. When
  3145.     we have completed making all programs in The A64 Package 680x0 compatible
  3146.     we will release them as an update.
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.  
  3164.  
  3165.  
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.  
  3173.  
  3174.  
  3175.  
  3176.  
  3177.  
  3178.  
  3179.  
  3180.  
  3181.                                                                         5-5
  3182.  
  3183.  
  3184.  
  3185. -
  3186.  
  3187.  
  3188.  
  3189. ROMS
  3190.  
  3191. WHAT IS ROM
  3192.  
  3193.     ROM is short for "READ ONLY MEMORY."  A ROM is a computer chip that is
  3194.     capable of storing a program and like its name implies, it is READ ONLY,
  3195.     which means you can not change the program it contains.  ROM unlike RAM
  3196.     (your computer's memory) does not loose its contents when your computer is
  3197.     turned off.  Computers usually come with ROM to tell it what to do when
  3198.     it's turned on.  Your Amiga uses a ROM called "KickStart."
  3199.  
  3200. THE C64's ROMS
  3201.  
  3202.     The C64 has two ROMs that contain its operating system.  One ROM holds the 
  3203.     C64's BASIC and the other ROM holds the C64's KERNAL.  A64 does not come
  3204.     with the C64's BASIC or KERNAL, because they are copyrighted.  Before you
  3205.     start worrying that A64 will not work without them, this is NOT the case.
  3206.     A64 contains a very complex C64 ROM emulation which allows A64 to run most
  3207.     C64 programs, without the C64's ROMs.
  3208.  
  3209. A64'S ROMS
  3210.  
  3211.     NOTE: This section of the manual gets a little technical by discussing
  3212.           machine language.  If you are not familiar with machine language you
  3213.           should still read this section and and try to follow it as best you
  3214.           can, it contains some important information about A64.
  3215.  
  3216.     As mentioned above, A64 comes with a very complex C64 ROM emulation, this
  3217.     ROM emulation will handle the majority of C64 programs, but not all of
  3218.     them.  To explain what A64's ROM emulation will and will not handle we need
  3219.     to discuss machine language.
  3220.  
  3221.     The C64's ROMs contain machine language programs.  Machine language
  3222.     programs are made up of opcodes.  Opcodes are machine language instructions
  3223.     that tell the computer to perform some tiny operation, like move a value
  3224.     from one place to another or perform some kind of operation to a value.  It
  3225.     takes many, many opcodes to perform even the simplest operations on your
  3226.     computer.  The C64's ROMs contain many thousands of these opcodes.  The
  3227.     C64's ROMs are located in the C64's memory map at 40960-49151 (BASIC) and
  3228.     57344-65535 (KERNAL), these numbers are called addresses.  To access the
  3229.     C64's ROMs and the opcodes they contain you need to JUMP to one of these
  3230.     addresses.  With BASIC this done with the command "SYS."
  3231.  
  3232.     For example, to reset the C64 (or A64), you can type the following:
  3233.  
  3234.        SYS 64738 [RETURN]
  3235.  
  3236.     This will cause the C64 (or A64) to enter the KERNAL ROM at address 64738
  3237.     and start executing machine language opcodes starting at that address.
  3238.  
  3239.     If you were to disassemble (a disassembler is a program that turns machine 
  3240.     language into a readable form) one of the C64's ROMs, you would get a
  3241.     listing similar to this:
  3242.  
  3243.  
  3244.  
  3245.  
  3246.  
  3247.                                                                         5-6
  3248.  
  3249.  
  3250.  
  3251. -
  3252.  
  3253.  
  3254.  
  3255.         40960   LDX #10
  3256.         40962    LDA #138
  3257.         40964    STA 1024
  3258.         40967    ...
  3259.  
  3260.     NOTE: This listing is only used as an example and is not part of the C64's
  3261.           ROMs.
  3262.  
  3263.     The listing shows ROM addresses followed by the opcode stored at each
  3264.     address.  Please note that the addresses are not perfectly consecutive,
  3265.     this is because different opcodes have different lengths.  If A64 was to
  3266.     JUMP into the ROMs, using the above example, it would handle JUMPING in at
  3267.     all of the shown addresses: 40960, 40962, 40964 and 40967.  The problem
  3268.     occurs if A64 tried to JUMP in at one of the addresses not shown, the
  3269.     addresses between opcodes.  Because of the way machine language is, it is
  3270.     possible for an opcode to have another opcode contained within it.  For
  3271.     example, if you disassembled the same code as above, but started at address
  3272.     40963, you would get a listing like this:
  3273.  
  3274.         40963    TXA
  3275.         40964    STA 1024
  3276.         40967    ...
  3277.  
  3278.     The opcode "TXA" at address 40963 is contained within the opcode "LDA #138"
  3279.     at address 40962.  This is what A64 will not handle, when emulating the
  3280.     C64's ROMs, the JUMPING into the ROMs between opcodes.  If you are running
  3281.     a program that tries to JUMP into the C64's ROMs between opcodes A64 will
  3282.     trap it and display an error requester telling you "PROGRAM TRYING TO
  3283.     EXECUTE BETWEEN OPCODES."  This problem is only apparent when JUMPING into
  3284.     the C64's ROMs between opcodes and is not a problem when running C64
  3285.     programs that use the same technique to JUMP within themselves.  This
  3286.     problem can be corrected by installing the C64's ROMs into A64.
  3287.  
  3288. INSTALLING THE C64 ROMS
  3289.  
  3290.     Installing the C64's ROMs into A64, basically involves saving the contents
  3291.     of the C64's ROMs (this must be done on a C64) to a C64 disk and then
  3292.     copying them to your A64 disk.  Installing the C64's ROMs into A64 is not
  3293.     difficult, but it does require a few small steps to accomplish.  Once the
  3294.     C64's ROMs are installed you never have to worry about them again.  A64
  3295.     will automatically load the C64's ROMs and use them whenever the above
  3296.     mentioned problem occurs.
  3297.  
  3298.     To install the C64 ROMs you need the following:
  3299.  
  3300.     A C64
  3301.     A C64 disk drive (i.e., 1541)
  3302.     A64's hardware interface
  3303.     A 5 1/4" disk, formatted on a C64, with at least 20k free
  3304.             (NOTE: You can format the C64 disk with the utility 64Cmd).
  3305.  
  3306.     and the following programs that are included with The A64 Package:
  3307.  
  3308.         SaveROMs
  3309.     AmigaTo64
  3310.     64ToAmiga
  3311.     StripLoadAddr
  3312.  
  3313.                                                                         5-7
  3314.  
  3315.  
  3316.  
  3317. -
  3318.  
  3319.  
  3320.  
  3321.     The following procedure outlines the installation of the C64 ROMs. Part of
  3322.     it has to be done on a C64 and the rest must be done from the CLI on an
  3323.     Amiga.  Your current directory from the CLI should be TheA64Package.
  3324.     For example, with the disk containing The A64 Package in drive 1, you
  3325.     should type:
  3326.  
  3327.         cd df1:TheA64Package
  3328.  
  3329.     The first thing you need to do is copy the C64 program "SaveROMs" from
  3330.     The A64 Package to a C64 disk.  This program is used to save the Commodore
  3331.     64's ROMs to a C64 disk.
  3332.  
  3333.         1. Install A64's hardware interface and connect a C64 disk drive to it
  3334.            (See INSTALLING A64'S HARDWARE INTERFACE in the GETTING STARTED
  3335.            section).
  3336.         2. With a C64 disk in the C64 drive, use the utility "AmigaTo64" to
  3337.            transfer the program "SaveROMs to the C64 disk.  To do this type the
  3338.            following from the CLI:
  3339.  
  3340.             A64Utilities/AmigaTo64 64Prgs/saveroms df8: [RETURN]
  3341.  
  3342.             (Note "saveroms" is in all lowercase letters)
  3343.  
  3344.     Now that the C64 program "SaveROMs" is on the C64 disk you need to load and
  3345.     run it on a C64:
  3346.  
  3347.         1. Either unplug the C64 disk drive from the interface or use another
  3348.            C64 disk drive and connect it to a C64.
  3349.         2. With the C64 disk containing the program "SaveROMs" in the C64 disk
  3350.            drive type the following on the C64:
  3351.  
  3352.             LOAD "SAVEROMS",8 [RETURN] 
  3353.  
  3354.         3. After the program is done loading type:
  3355.  
  3356.             RUN [RETURN]
  3357.  
  3358.         4. You will then be prompted to insert a disk into drive 8 and press
  3359.            any key when ready.
  3360.         5. After pressing any key the C64 ROMs will be saved to the C64 disk.
  3361.  
  3362.     Now that the C64's ROMs are saved to a C64 disk you need to transfer them
  3363.     to your disk containing The A64 Package.
  3364.  
  3365.         1. If you need to reconnect the C64 disk drive to your Amiga with A64's
  3366.            hardware interface, do so.
  3367.         2. With the program "64ToAmiga" transfer the files BASIC.rom and
  3368.            KERNAL.rom from the C64 disk to your disk containing The A64
  3369.            Package.  To do this type the following from the CLI:
  3370.  
  3371.             A64Utilities/64ToAmiga basic.rom BASIC.rom [RETURN]
  3372.  
  3373.             and then:
  3374.  
  3375.             A64Utilities/64ToAmiga kernal.rom KERNAL.rom [RETURN]
  3376.  
  3377.  
  3378.  
  3379.                                                                         5-8
  3380.  
  3381.  
  3382.  
  3383. -
  3384.  
  3385.  
  3386.  
  3387.         3. After the C64's ROMs are installed onto The A64 Package disk you
  3388.            must run "StripLoadAddr" on them before A64 can use them. To do this
  3389.            type the following from the CLI:
  3390.  
  3391.             A64Utilities/StripLoadAddr BASIC.rom [RETURN]
  3392.  
  3393.             and then:
  3394.  
  3395.             A64Utilities/StripLoadAddr KERNAL.rom [RETURN]
  3396.  
  3397.     The C64's ROMs are now installed.  A64 will automatically load and use them
  3398.     when needed.
  3399.  
  3400.     NOTE: If you are running A64 with 512k RAM, installing the C64's ROMs will
  3401.           replace A64's ROM emulation and save you about 135k of RAM, but will
  3402.           result in A64 running slower.  Because A64's ROM emulation operates
  3403.           much faster than the C64 ROMs do, A64 will try to use its ROM
  3404.           emulation whenever possible and if you are running A64 with 1mb or
  3405.           more, the C64's ROMs will only be used as a fail-safe when the above
  3406.           mentioned problem occurs.
  3407.  
  3408.  
  3409.  
  3410.  
  3411.  
  3412.  
  3413.  
  3414.  
  3415.  
  3416.  
  3417.  
  3418.  
  3419.  
  3420.  
  3421.  
  3422.  
  3423.  
  3424.  
  3425.  
  3426.  
  3427.  
  3428.  
  3429.  
  3430.  
  3431.  
  3432.  
  3433.  
  3434.  
  3435.  
  3436.  
  3437.  
  3438.  
  3439.  
  3440.  
  3441.  
  3442.  
  3443.  
  3444.  
  3445.                                                                         5-9
  3446.  
  3447.  
  3448.  
  3449. -
  3450.  
  3451.  
  3452.  
  3453. PROBLEMS AND SOLUTIONS
  3454.  
  3455.     I can't get programs in The A64 Package to recognize a C64 disk drive.
  3456.  
  3457.         First of all make sure the hardware interface is installed correctly
  3458.         (See INSTALLING A64'S HARDWARE INTERFACE in the GETTING STARTED
  3459.         section).  If you think the interface is installed correctly then try
  3460.         turning the disk drive of and then on again, this will reset the disk
  3461.         drive.  The C64 disk drives may need to be reset from time to time when
  3462.         running A64.  If you are running a C64 program that used copy
  3463.         protection you may have to reset the drive to clear it.
  3464.  
  3465.     When trying to load a C64 program the C64 disk drive light comes on but the
  3466.     program doesn't load and A64 appears to have locked up.
  3467.  
  3468.         The program you are trying to load may be using a technique called
  3469.         "FAST LOADING."  FAST LOADING is a technique used to to speed up
  3470.         communications with a C64 disk drive.  A64 can not handle FAST LOADING
  3471.         (See INCOMPATIBILITIES in the PROBLEMS and SOLUTIONS section).  If this
  3472.         situation occurs you will have to reset the C64 drive and then reset
  3473.         A64.
  3474.  
  3475.     I think my hardware interface is faulty.
  3476.  
  3477.         We have a VERY low failure rate with our hardware interfaces.  Usually
  3478.         when a problem occurs it is because of something not being done
  3479.         correctly or by trying to do something that A64 will not handle. If you
  3480.         think you're interface is bad you can run the program "64Status" to
  3481.         test it (See 64Status in the UTILITIES section).  If this program works
  3482.         as its supposed to then your interface is not faulty and the problem
  3483.         lies somewhere else.  Please note that if the 64Status program doesn't
  3484.         work it is still possible that the interface is still not faulty.  We
  3485.         know of a couple of people who have "blown" their parallel port by
  3486.         plugging in the interface or some other piece of hardware with their
  3487.         Amiga turned on.  Before concluding that the interface is faulty you
  3488.         should try using some other piece of hardware on your Amiga's parallel
  3489.         port like a parallel printer or digitizer.  If they work, and the
  3490.         interface doesn't, then you probably do have a faulty interface.  You
  3491.         could also try to test the interface on someone elses Amiga.  If you
  3492.         do have a faulty interface we will replace it (See REPLACEMENTS on page
  3493.         2).
  3494.  
  3495.     When moving the mouse strange characters appear on the screen and the
  3496.     keyboard doesn't work.
  3497.  
  3498.         See GAME PORTS in the SYSTEM MENU section.
  3499.  
  3500.     For more information on other possible problems see A64 PREFS NOTES in the
  3501.     A64 PREFS section.
  3502.  
  3503.  
  3504.  
  3505.  
  3506.  
  3507.  
  3508.  
  3509.  
  3510.  
  3511.                                                                         6-1
  3512.  
  3513.  
  3514.  
  3515. -
  3516.  
  3517.  
  3518.  
  3519. A64 ERRORS
  3520.  
  3521.     A64 has quite an extensive error handling system.  A64 does its best to
  3522.     tell you when it can't do something by displaying a requester.  These
  3523.     requesters are called error requesters and they display an error in three
  3524.     ways:
  3525.  
  3526.         1. At the top of the requester will be the type of error, either FATAL
  3527.            or NON-FATAL.  The meaning of each is as follows:
  3528.  
  3529.             FATAL ERRORs are just as the name implies, FATAL to A64.  If you
  3530.             get a fatal error this means that A64 has encountered some
  3531.             situation that will forbid it to continue and it will have to exit
  3532.             back to WorkBench.  After you handle the requester, by selecting
  3533.             one of its gadgets, a fatal error will force A64 to remove itself
  3534.             from memory and return you to the WorkBench.  Fatal errors usually
  3535.             occur only during the loading and initialization of A64.
  3536.  
  3537.             NON-FATAL ERRORs are a little more forgiving than FATAL errors.
  3538.             They signify that A64 has encountered some situation that it can
  3539.             not currently handle, but which is not serious enough to cause A64
  3540.             to exit back to the WorkBench.  After you handle the requester, by
  3541.             selecting one of its  gadgets, A64 will automatically leave you in
  3542.             A64 Prefs to try to correct the situation that caused the error.
  3543.             After being put into A64 Prefs your choice of action depends on
  3544.             what caused the error.  If you are unable to correct the situation
  3545.             that caused the error then you should reset A64 (See RESET A64 in
  3546.             the PROJECT MENU section).
  3547.  
  3548.         2. Following the type of error will be an eight digit error number.
  3549.            This error number is an error code that represents the exact cause
  3550.            and location of the error.
  3551.  
  3552.         3. In the middle of the requester will be one or two lines of text
  3553.            giving a short description of the error.
  3554.  
  3555.     At the bottom of the error requester are two gadgets, labeled CONTINUE and
  3556.     DEBUG.  Their functions are:
  3557.  
  3558.     CONTINUE will cause A64 to remove the requester.  You will then either
  3559.         be returned to WorkBench or put into A64 Prefs depending on the type of
  3560.         error (FATAL or NON-FATAL) discussed above.
  3561.  
  3562.     DEBUG will cause A64 to put up an Alert showing the internal state of
  3563.         A64 when the error occurred.  This information will probably not mean
  3564.         anything to you, but it can be invaluable to us for tracking down
  3565.         errors.  After viewing the information in the Alert press a mouse
  3566.         button to remove the Alert.  You will then either be returned to
  3567.         the WorkBench or put into A64 Prefs depending on the type of error
  3568.         (FATAL or NON-FATAL) discussed above.
  3569.  
  3570.         NOTE: In the appendices of this manual is an ERROR REPORT.  If you are
  3571.               experiencing problems with a particular C64 program, or if you
  3572.               encounter an error that is not in the error list, you can send us
  3573.               a copy of the ERROR REPORT containing the information displayed
  3574.               in the Alert.  We will try to correct as many errors as possible
  3575.               for future releases.    
  3576.  
  3577.                                                                         6-2
  3578.  
  3579.  
  3580.  
  3581. -
  3582.  
  3583.  
  3584.  
  3585. ERROR LIST
  3586.  
  3587.     The following list contains A64's possible errors.  The errors are shown by
  3588.     the error number followed by a line stating the error, which should be the
  3589.     same text that appears in the error requester.  Below the line stating the
  3590.     error is a short comment on what caused the error, how to correct it and
  3591.     what section of the manual to check for more information.
  3592.  
  3593.     Errors that state "Should NEVER happen" should never occur, but if they do
  3594.     the probable cause is that something has corrupted your Amiga's memory or
  3595.     that you are out of memory.
  3596.  
  3597.     The appearance of a "x" in an error number means, that digit of the error
  3598.     number will contain some unpredetermined value.  There may be a comment
  3599.     stating what the digit will be.
  3600.  
  3601.     Error numbers that start with 8 are FATAL errors.  All other errors are
  3602.     NON-FATAL.
  3603.  
  3604.     Multiple error numbers mean that the error can be generated in more than
  3605.     one place in A64.
  3606.  
  3607.  
  3608. $80000001    COULD NOT OPEN: DOS LIBRARY
  3609.         Should NEVER happen.
  3610.  
  3611. $80000002    COULD NOT OPEN: GRAPHICS LIBRARY
  3612.         Should NEVER happen.
  3613.  
  3614. $80000003    COULD NOT OPEN: DISKFONT LIBRARY
  3615.         Make sure the file diskfont.lib is in your WorkBench's Libs
  3616.         directory (See THE A64 PACKAGES FILE STRUCTURE in the TECHNICAL
  3617.         section).
  3618.  
  3619. $80000004    COULD NOT OPEN: CIA A RESOURCE
  3620.         Should NEVER happen.
  3621.  
  3622. $80000005    COULD NOT OPEN: CIA B RESOURCE
  3623.         Should NEVER happen.
  3624.  
  3625. $80000006    COULD NOT OPEN: MISC RESOURCE
  3626.         Should NEVER happen.
  3627.  
  3628. $80000007    OUT OF MEMORY, COULD NOT ALLOCATE: C64 MEMORY MAP
  3629.         You do not have enough RAM available to run A64 (See A64 AND
  3630.         MEMORY in the TECHNICAL section).
  3631.  
  3632. $8f000108    COULD NOT OPEN OR READ: BASIC.DATA
  3633. $8f000208    Make sure the file BASIC.data is in the TheA64Package
  3634.         directory (See THE A64 PACKAGES FILE STRUCTURE in the TECHNICAL
  3635.         section).
  3636.  
  3637. $8f000109    COULD NOT OPEN OR READ: KERNAL.DATA
  3638. $8f000209    Make sure the file KERNAL.data is in the TheA64Package
  3639.         directory (See THE A64 PACKAGES FILE STRUCTURE in the TECHNICAL
  3640.         section).
  3641.  
  3642.  
  3643.                                                                         6-3
  3644.  
  3645.  
  3646.  
  3647. -
  3648.  
  3649.  
  3650.  
  3651. $8f00010a    COULD NOT OPEN OR READ: CHARROM.64FONT
  3652. $8f00020a     Make sure the file CharROM.64Font is in the 64Fonts directory
  3653.         (See THE A64 PACKAGES FILE STRUCTURE in the TECHNICAL section).
  3654.  
  3655. $8000000b    OUT OF MEMORY, COULD NOT ALLOCATE: A64 ROM BUFFER
  3656.         You do not have enough RAM available to run A64 (See A64 AND
  3657.         MEMORY in the TECHNICAL section).  You may be able to correct
  3658.                 this error by installing the C64's ROMs (See INSTALLING THE
  3659.         C64's ROMs in the ROMs section).
  3660.  
  3661. $8f00010c    COULD NOT OPEN OR READ: ROM
  3662. $8f00020c    Make sure the file ROM is in the TheA64Package directory (See
  3663.         THE A64 PACKAGES FILE STRUCTURE in the TECHNICAL section).
  3664.  
  3665. $8000000d    COULD NOT: INSTALL A64 ROMs
  3666.         This error should never occur, if it does something has
  3667.         probably corrupted the Amiga's memory.
  3668.  
  3669. $8000000e    A64 WILL NOT RUN WITH INSTALLED MICROPROCESSOR
  3670.         You are trying to run the wrong version of A64 for your Amiga
  3671.         (See 680x0 SUPPORT in the TECHNICAL section).
  3672.  
  3673. $8000000f    YOU CAN NOT RUN TWO COPIES OF A64 SIMULTANEOUSLY
  3674.         A64 can not multitask itself (See A64 AND MULTITASKING in the
  3675.         TECHNICAL section).        
  3676.  
  3677. $80010000    OUT OF MEMORY, COULD NOT ALLOCATE: CHIP RAM 1
  3678.         You do not have enough RAM available to run A64 (See A64 AND
  3679.         MEMORY in the TECHNICAL section).
  3680.  
  3681. $80010001    OUT OF MEMORY, COULD NOT ALLOCATE: CHIP RAM 2
  3682.         You do not have enough RAM available to run A64 (See A64 AND
  3683.         MEMORY in the TECHNICAL section).
  3684.  
  3685. $80010002    OUT OF MEMORY, COULD NOT ALLOCATE: CHIP RAM 3
  3686.         You do not have enough RAM available to run A64 (See A64 AND
  3687.         MEMORY in the TECHNICAL section).
  3688.  
  3689. $8f010x03    COULD NOT OPEN OR READ: TITLE
  3690. $8f010x04    Make sure the file Title is in the TheA64Package directory (See
  3691. $8f010x05    THE A64 PACKAGES FILE STRUCTURE in the TECHNICAL section).
  3692. $8f010x06    The "x" in the error number will be either 1 or 2.
  3693.  
  3694. $80010007    COULD NOT OPEN: TITLE SCREEN
  3695.         If this error occurs you are probably out of memory (See A64
  3696.         AND MEMORY in the TECHNICAL section).
  3697.  
  3698. $80010008    COULD NOT OPEN: TITLE WINDOW
  3699.         If this error occurs you are probably out of memory (See A64
  3700.         AND MEMORY in the TECHNICAL section).
  3701.  
  3702. $80010009    COULD NOT OPEN: A64 SCREEN
  3703.         If this error occurs you are probably out of memory (See A64
  3704.         AND MEMORY in the TECHNICAL section).
  3705.  
  3706.  
  3707.  
  3708.  
  3709.                                                                         6-4
  3710.  
  3711.  
  3712.  
  3713. -
  3714.  
  3715.  
  3716.  
  3717. $8001000a    COULD NOT OPEN: A64 WINDOW
  3718.         If this error occurs you are probably out of memory (See A64
  3719.         AND MEMORY in the TECHNICAL section).
  3720.  
  3721. $8001000b    COULD NOT OPEN: A64 6 FONT
  3722.         Make sure you have installed the font with InstallA64Font (See
  3723.         RUNNING A64 in the GETTING started section and InstallA64Font
  3724.         in the UTILITIES section).  If you still get this error after
  3725.         installing the font you are probably out of memory (See A64 AND
  3726.         MEMORY in the TECHNICAL section).
  3727.  
  3728. $8001000c    COULD NOT OPEN: TOPAZ 8 FONT
  3729.         Should NEVER happen.
  3730.  
  3731. $8f01010d    COULD NOT OPEN OR READ: LIC
  3732. $8f01020d    Make sure the file Lic is in the TheA64Package directory (See
  3733.         THE A64 PACKAGES FILE STRUCTURE in the TECHNICAL section).
  3734.  
  3735. $00020000    COULD NOT OPEN: REQUESTER
  3736.         If this error occurs you are probably out of memory (See A64
  3737.         AND MEMORY in the TECHNICAL section).
  3738.  
  3739. $00020001    COULD NOT: LOCK A64 PREFS SCREEN
  3740.         This error should never occur, if it does something has
  3741.         probably corrupted the Amiga's memory.
  3742.  
  3743. $0f020102    COULD NOT OPEN OR READ: CONFIG FILE
  3744. $0f020202    The configuration file your trying to load can not be loaded.
  3745.         Check the spelling of the filename (See LOAD CONFIG in the
  3746.         PROJECT MENU section).  If this error occurs when A64 is
  3747.         loading then it can not read the file A64.config and you
  3748.         should make sure this file is in the TheA64Package directory
  3749.         (See THE A64 PACKAGES FILE STRUCTURE in the TECHNICAL section).
  3750.  
  3751. $0f020103    COULD NOT OPEN OR WRITE: CONFIG FILE
  3752. $0f020303    For some reason A64 can not create the configuration file you
  3753.         requested.  Make sure you've specified the correct drive and
  3754.         that the disk is write enabled. (See SAVE CONFIG in the PROJECT
  3755.         MENU section)
  3756.  
  3757. $00030000    COULD NOT TAKE: PARALLEL PORT
  3758.         Some program has exclusive use of the Amiga's parallel port.
  3759.         You must make the program release the parallel port before A64
  3760.         can use it (See PAR PORT in the SYSTEM MENU section).
  3761.  
  3762. $00040000    A64 DOES NOT OWN THE PARALLEL PORT
  3763.         You are trying to access the parallel port when A64 does not
  3764.         own it.  Select A64 in PAR PORT menu option (See PAR PORT in
  3765.         the SYSTEM MENU section).
  3766.  
  3767. $00040001    ERROR TRYING TO WRITE TO AN AMIGA DEVICE
  3768. $00040002    Some problem has occurred when trying to write a file to an
  3769. $00040003    Amiga drive.  Make sure you've specified the correct drive and
  3770.         that the disk is write enabled. (See DRIVES and AMIGA DRIVES
  3771.         in the SYSTEM MENU section).
  3772.  
  3773.  
  3774.  
  3775.                                                                         6-5
  3776.  
  3777.  
  3778.  
  3779. -
  3780.  
  3781.  
  3782.         
  3783. $00040004    ILLEGAL ACCESS TO AMIGA DEVICE CAN NOT USE COMMAND CHANNEL 15
  3784.         The C64 program you are running is trying to access a disk
  3785.         drive in a way that an Amiga drive can not handle (See AMIGA
  3786.         DRIVES in the SYSTEM MENU section).
  3787.  
  3788. $00040005    ERROR TRYING TO SAVE TO AN AMIGA DEVICE
  3789. $00040006    Some problem has occurred when trying to save a file to an
  3790. $00040007    Amiga drive.  Make sure you've specified the correct drive and
  3791.         that the disk is write enabled. (See DRIVES and AMIGA DRIVES
  3792.         in the SYSTEM MENU section).
  3793.  
  3794. $00040008    ERROR TRYING TO LOAD FROM AN AMIGA DEVICE
  3795. $00040009    Some problem has occurred when trying to load a file from an
  3796. $0004000a    Amiga drive.  Check the spelling of the filename and the DRIVES
  3797.         settings (See DRIVES and AMIGA DRIVES in the SYSTEM MENU
  3798.         section).
  3799.  
  3800. $0004000b    ERROR TRYING TO READ FROM AN AMIGA DEVICE
  3801. $0004000c    Some problem has occurred when trying to read a file from an
  3802. $0004000d    Amiga drive.  Check the spelling of the filename and the DRIVES
  3803.         settings (See DRIVES and AMIGA DRIVES in the SYSTEM MENU
  3804.         section).
  3805.  
  3806. $80050000    COULD NOT OPEN: MSGPORT
  3807.         Should NEVER happen.
  3808.  
  3809. $80050001    COULD NOT OPEN: REPLY PORT
  3810.         Should NEVER happen.
  3811.  
  3812. $80050002    COULD NOT OPEN: INPUT DEVICE
  3813.         Should NEVER happen.
  3814.  
  3815. $80050003    COULD NOT: ADD IEHANDLER
  3816.         Should NEVER happen.
  3817.  
  3818. $80050004    COULD NOT: DOIO.
  3819.         Should NEVER happen.
  3820.  
  3821. $80060000    COULD NOT TAKE: CIA A: SERIAL DATA INTERRUPT
  3822.         You are running another program that is utilizing a low level
  3823.         function of your Amiga.  The other program must be exited
  3824.         before A64 will run (See A64 AND MULTITASKING in the TECHNICAL
  3825.            section).
  3826.  
  3827. $80060001    COULD NOT FREE: CIA A: SERIAL DATA INTERRUPT
  3828.         Should NEVER happen.
  3829.  
  3830. $80070000    COULD NOT TAKE: CIA B: TIMER B INTERRUPT
  3831.         You are running another program that is utilizing a low level
  3832.         function of your Amiga.  The other program must be exited
  3833.         before A64 will run (See A64 AND MULTITASKING in the TECHNICAL
  3834.            section).
  3835.  
  3836.  
  3837.  
  3838.  
  3839.  
  3840.  
  3841.                                                                         6-6
  3842.  
  3843.  
  3844.  
  3845. -
  3846.  
  3847.  
  3848.  
  3849. $80080000    COULD NOT TAKE: CIA B: TOD INTERRUPT
  3850.         You are running another program that is utilizing a low level
  3851.         function of your Amiga.  The other program must be exited
  3852.         before A64 will run (See A64 AND MULTITASKING in the TECHNICAL
  3853.            section).
  3854.  
  3855. $80080001    COULD NOT FREE: CIA B: TOD INTERRUPT
  3856.         Should NEVER happen.
  3857.  
  3858. $00080002    PROGRAM HAS OVER 25 RASTER IRQs
  3859.         A64 will support up to 25 raster IRQs per screen, this is the
  3860.         equivalent of 1500 interrupts per second and we've not yet come
  3861.         across a C64 program that utilizes anywhere near this many.  If
  3862.         you get this error we would like to hear about it.
  3863.  
  3864. $00080003    PROGRAM DOING UNIMPLEMENTED RASTER IRQ AT SCAN LINE 0
  3865.         A64 will handle raster IRQs at every scan line except 0.  This
  3866.         is because of a problem with the raster IRQ handler and will be
  3867.         fixed in a future version.
  3868.  
  3869. $00090000    COULD NOT TAKE: SERIAL PORT
  3870.         Some program has exclusive use of the Amiga's serial port.
  3871.         You must make the program release the serial port before A64
  3872.         can use it (See SER PORT in the SYSTEM MENU section).
  3873.  
  3874. $00090001    RS-232 ERROR: RECEIVE BUFFER OVERRUN
  3875.         A64 is not keeping up with the data coming in over the serial
  3876.         port. This has not been a problem so we have never seen this
  3877.         error.
  3878.  
  3879. $00090002    RS-232 ERROR: RECEIVE BUFFER FULL
  3880.         A64 is not keeping up with the data coming in over the serial
  3881.         port. This has not been a problem so we have never seen this
  3882.         error.
  3883.  
  3884. $000c0000    ILLEGAL VIC MODE:
  3885.         Should NEVER happen.
  3886.  
  3887. $000d0x01    BLITTER VSIZE ERROR: VSIZE = 0
  3888. $000d0x03    Should NEVER happen.  The "x" in the error number will be the
  3889. $000d0x05    number 1-6.
  3890.  
  3891. $000d0x02    BLITTER VSIZE ERROR: VSIZE > 8
  3892. $000d0x04    Should NEVER happen.  The "x" in the error number will be the
  3893. $000d0x06    number 1-6.
  3894.  
  3895. $000e0000    COULD NOT OPEN OR WRITE: IFF OUTPUT FILE
  3896. $000e0001    For some reason A64 could not create the IFF file you've
  3897.         requested.  Make sure you've entered the filename correctly
  3898.         (See SAVE SCREEN in the TOOLS MENU section).
  3899.  
  3900. $000e0002    OUT OF MEMORY, COULD NOT ALLOCATE: IFF FILE BUFFER
  3901.         A64 does not have enough memory to perform the operation (See
  3902.         A64 AND MEMORY in the TECHNICAL section).
  3903.  
  3904.  
  3905.  
  3906.  
  3907.                                                                         6-7
  3908.  
  3909.  
  3910.  
  3911. -
  3912.  
  3913.  
  3914.  
  3915. $000f0000    A64 HARDWARE INTERFACE IS NOT INSTALLED
  3916.         A64's hardware interface is not connected to the Amiga.  You
  3917.         must connect it (See INSTALLING A64's HARDWARE INTERFACE in the
  3918.         GETTING STARTED section).
  3919.  
  3920. $00100000    OUT OF MEMORY, COULD NOT ALLOCATE: CHIP RAM
  3921.         A64 does not have enough memory to perform the operation (See
  3922.         A64 AND MEMORY in the TECHNICAL section).
  3923.  
  3924. $00100001    COULD NOT OPEN: COLOR SCREEN
  3925.         If this error occurs you are probably out of memory (See A64
  3926.         AND MEMORY in the TECHNICAL section).
  3927.  
  3928. $00100002    COULD NOT OPEN: COLOR WINDOW
  3929.         If this error occurs you are probably out of memory (See A64
  3930.         AND MEMORY in the TECHNICAL section).
  3931.  
  3932. $xxxxxxxx    PROGRAM TRYING TO EXECUTE BETWEEN OPCODES AT PC: $xxxxxxxx
  3933.         The program is executing between opcodes.  This error can be
  3934.         corrected by installing the C64 ROMs (See ROMs in the TECHNICAL
  3935.         section).
  3936.  
  3937. $xxxxxxxx    UNKNOWN OPCODE: $xx AT PC: $xxxxxxxx
  3938.         A64 has encountered an unknown opcode.  This could be caused
  3939.         either a C64 crash or A64 trying to execute certain
  3940.         unimplemented "undefined opcodes."  Many of the 6502's
  3941.         undefined opcodes have been supported, but we lack good
  3942.         documentation on them, so when in doubt we left it out. If
  3943.         anyone out there has any documentation on the 6502's undefined
  3944.         opcodes we would greatly appreciate getting a copy so we could
  3945.         fully implement the 6502's undefined opcodes.
  3946.  
  3947. $xxxxxxxx    PC ERROR
  3948.         A64 is trying to execute at an illegal C64 address. The only
  3949.         way we know of this error occurring is if a C64 program tries to
  3950.         execute in the CHAR ROM area, a very unlikely occurrence, but
  3951.         we have learned that if something is possible on a C64, someone
  3952.         has done it. If you encounter this error we would like to hear
  3953.         about it.
  3954.  
  3955.  
  3956.  
  3957.  
  3958.  
  3959.  
  3960.  
  3961.  
  3962.  
  3963.  
  3964.  
  3965.  
  3966.  
  3967.  
  3968.  
  3969.  
  3970.  
  3971.  
  3972.  
  3973.                                                                         6-8
  3974.  
  3975.  
  3976.  
  3977. -
  3978.  
  3979.  
  3980.  
  3981. INCOMPATIBILITIES
  3982.  
  3983.     Alot of time has been spent trying to make A64 as compatible as possible.
  3984.     Unfortunately the only way to get 100% compatibility with a C64 is to use a
  3985.     C64.  Listed below are the things that A64 does not currently handle:
  3986.  
  3987. FAST LOADERS
  3988.  
  3989.     The biggest problem with compatibility is related to disk I/O.  We all know
  3990.     how slow the 1541 disk drive is and alot of software manufactures try to
  3991.     correct this problem by writing custom disk drive routines, called FAST
  3992.     LOADERS, to load and save programs faster than the normal rate.  These
  3993.     routines are VERY time critical and must be run at 100% speed, with no
  3994.     interruptions, to function properly.  Also these routines vary from program
  3995.     to program.  A FAST LOADER that works with one program will not work with 
  3996.     another.  The only way to emulate these routines is to write a custom
  3997.     loader for each program that utilizes a FAST LOADER.  Seeing how there are
  3998.     literally hundreds of FAST LOADER programs out there it would be nearly
  3999.     impossible to emulate all of them.
  4000.  
  4001.     There is no way to tell if a program uses a FAST LOADER until you try to
  4002.     load it.  The must likely result of trying to load a program that uses one
  4003.     is the C64 program will stop and disk drive motor and or light will stay
  4004.     on.  If this happen you must reset both A64 and the disk drive to abort
  4005.     the operation (See RESET A64 in the PROJECT MENU section).
  4006.  
  4007.     Future revisions of A64 may emulate some FAST LOADERS. If you have a
  4008.     program that uses a FAST LOADER and you would like to see A64 run it, put
  4009.     the name of it on the registration form or write us a letter.  We will
  4010.     spend the time working on the must requested programs.
  4011.  
  4012. CASSETTE PORT, USER PORT and CARTRIDGE PORT
  4013.  
  4014.     Seeing how the cassette, user and cartridge ports are not present on the
  4015.     Amiga they are not supported by A64.  There is an exception to this in that
  4016.     Amiga modems are supported where C64 modems are normally connected to the
  4017.     C64 user port (See MODEMS in the SYSTEM MENU section).  Also cartridge
  4018.     programs that have been converted to run from disk should work.
  4019.  
  4020.  
  4021.  
  4022.  
  4023.  
  4024.  
  4025.  
  4026.  
  4027.  
  4028.  
  4029.  
  4030.  
  4031.  
  4032.  
  4033.  
  4034.  
  4035.  
  4036.  
  4037.  
  4038.  
  4039.                                                                         6-9
  4040.  
  4041.  
  4042.  
  4043. -
  4044.  
  4045.  
  4046.  
  4047. KNOWN BUG
  4048.  
  4049.     Although we have painstakingly tried to make A64 bug free, a bug turned up
  4050.     during testing and was not corrected in time for this release.  This bug is
  4051.     easily avoided and we do plan on trying to correct it in a future release.
  4052.     We hope no other bugs have escaped our attention, but if you do come across
  4053.     one, please let us know so that we can try to correct it.
  4054.  
  4055.     The bug involves the PAR PORT menu option in the SYSTEM menu.  When this
  4056.     option is set to A64 and you try to access the parallel port from another
  4057.     program a GURU MEDITATION error will occur.  This bug seems to be in the
  4058.     Amiga's parallel device handler.  It appears that the parallel device
  4059.     handler is not doing the correct error handling when the parallel port is
  4060.     not available for use.  The way to avoid this bug is whenever you want to
  4061.     access the parallel port from another program besides A64 make sure the PAR
  4062.     PORT menu option is set to AMIGA.
  4063.  
  4064.     NOTE: This bug is not present for the serial port.
  4065.  
  4066.  
  4067.  
  4068.  
  4069.  
  4070.  
  4071.  
  4072.  
  4073.  
  4074.  
  4075.  
  4076.  
  4077.  
  4078.  
  4079.  
  4080.  
  4081.  
  4082.  
  4083.  
  4084.  
  4085.  
  4086.  
  4087.  
  4088.  
  4089.  
  4090.  
  4091.  
  4092.  
  4093.  
  4094.  
  4095.  
  4096.  
  4097.  
  4098.  
  4099.  
  4100.  
  4101.  
  4102.  
  4103.  
  4104.  
  4105.                                                                         6-10
  4106.  
  4107.  
  4108.  
  4109. -
  4110.  
  4111.  
  4112.  
  4113. WHAT IS IN THE FUTURE
  4114.  
  4115.     We can just about guarantee at least one revision of The A64 Package, there
  4116.     has been just too much work already done, on other features, not to update
  4117.     it.  As far as, when The A64 Package will be updated and how many new
  4118.     features are added, depends on how many people support The A64 Package, by
  4119.     sending in the license fee.  The more response we get, the more willing
  4120.     we'll be to spend the time adding new features and to get new versions of
  4121.     The A64 Package out there.
  4122.  
  4123.     The features that have been worked on (or at least given some serious
  4124.     consideration), that didn't make it into this release of The A64 Package,
  4125.     are almost too numerous to mention.  We have put together a list of some of
  4126.     the more important features that we would like to add to future versions.
  4127.     If you have any suggestions or comments about new features, we would like
  4128.     to hear about them, put them on the registration form when sending in the
  4129.     license fee.
  4130.  
  4131.         SOUND: We realize that many of you think sound support is VERY
  4132.         important and so do we.  We have a very talented programmer working
  4133.         solely on sound support and he has made excellent progress with this
  4134.         complex programming task.  He will complete the sound support in the
  4135.         very near future and it will be included with the next release.
  4136.  
  4137.         A64MON: A64Mon is an Amiga based, C64 system monitor. A64Mon is a
  4138.         powerful C64 debugging and hacking tool, it give you the ability to
  4139.         stop any C64 program, that A64 is running, and examine its internals.
  4140.         A64Mon is an Amiga program, so it runs totally transparent to the C64
  4141.         program that A64 is running, there is no stopping it from working.
  4142.         A64Mon has numerous features and commands that make "monitoring" a C64
  4143.         program a snap.  Some of its features include: PetASCII dump,
  4144.         disassembler, chip dumps, hex dump, edit memory, saving from and loading
  4145.         to the C64's memory map, all command output can be sent to Amiga disks
  4146.         or printers and it's all done in the Amiga environment.  A64Mon was
  4147.         used quite extensively during the development of A64 and we found it
  4148.         an invaluable tool for finding out "what is the C64 program doing." 
  4149.         A64Mon is about 80% completed and it will be be included with the next
  4150.         release.
  4151.  
  4152.         AMIGA PRINTERS: A64 will have the ability to use Amiga printers in the
  4153.         same way it's able to use Amiga drives.
  4154.  
  4155.         AMIGA DRIVES: While the Amiga drive support is fully functional, it can
  4156.         be improved. Some of the drawbacks of Amiga drives are outlined in the
  4157.         AMIGA DRIVES section.
  4158.  
  4159.         C64 DEVICES: This one is a big one.  The A64 Package comes with some
  4160.         utility programs that allow you to transfer C64 programs to and from
  4161.         Amiga disks.  The key to these utilities is the ability to access C64
  4162.         devices directly from AmigaDOS.  By using this ability several other
  4163.         programs can be developed, like: a full featured, Amiga based, file
  4164.         transfer program and device drivers to use C64 disk drives and printers
  4165.         as Amiga devices so they can be used with ANY Amiga program.  Quite a
  4166.         bit of work has already been done in this area, but to fully develop
  4167.         these features, The A64 Package needs alot of support.
  4168.  
  4169.  
  4170.  
  4171.                                                                         7-1
  4172.  
  4173.  
  4174.  
  4175. -
  4176.  
  4177.  
  4178.  
  4179.         MODEMS: Amiga modem support is still in development and should be
  4180.         completed by the next release.
  4181.  
  4182.         INPUT DEVICES: A64 will support more C64 input devices, like paddles
  4183.         and C64 mice.  We have also considered using the Amiga's mouse to
  4184.         emulate certain C64 input devices.
  4185.  
  4186.         FAST LOADERS: We would like to support some FAST LOADERS in the future.
  4187.         A couple that we've considered are: GEOS and ISEPIC.  Let us know if
  4188.         you have others in mind.
  4189.  
  4190.         FILE REQUESTERS: Full featured file requesters in A64 Prefs.
  4191.  
  4192.         A64 PREFS SETTINGS: A64 Prefs will have many more settings that allow
  4193.         you to fine tune A64 to run a C64 program.  A64 was designed to be able
  4194.         to do many things at variable rates; like redraw the screen, handle C64
  4195.         interrupts and other things that effect the speed of A64.  In the
  4196.         future A64 Prefs will give you the ability to change these rates to
  4197.         make A64 run faster.
  4198.  
  4199.         COLOR SCREEN: The A64 COLORS' screen is still in development and when
  4200.         it's  completed it will have many new features, like: UNDO, COPY, SWAP,
  4201.         SPREAD, etc.  It should be noted that the COLORS' screen is fully
  4202.         functional as is and should not contain any bugs.
  4203.  
  4204.         SPRITES: A64 fully supports the C64's sprites, but work can be done in
  4205.         a number of areas concerning them, especially their flickering.
  4206.  
  4207.         FONTS: A64 will have the ability to change, load and save C64 fonts and
  4208.         maybe the ability to convert C64 fonts to Amiga fonts.
  4209.  
  4210.         And the list could go on and on...
  4211.  
  4212.     NOTE:  Even if this list already contains the features that YOU would like
  4213.            to see added to The A64 Package, you should still let us know what
  4214.            they are, to help us decide what features are more important to add
  4215.            first. 
  4216.  
  4217.  
  4218.  
  4219.  
  4220.  
  4221.  
  4222.  
  4223.  
  4224.  
  4225.  
  4226.  
  4227.  
  4228.  
  4229.  
  4230.  
  4231.  
  4232.  
  4233.  
  4234.  
  4235.  
  4236.  
  4237.                                                                         7-2
  4238.  
  4239.  
  4240.  
  4241. -
  4242.  
  4243.  
  4244.  
  4245. ERROR REPORT
  4246.  
  4247.     We have supplied an ERROR REPORT that you can send to us if you are
  4248.     experiencing difficulties with running a certain C64 program on A64.  This
  4249.     error report will help us to track down problems more easily and to get
  4250.     better revisions of A64 out quickly.  We realize that the majority of the
  4251.     people using A64 will not use these error reports, but if some of you do it
  4252.     will make our job a little easier.  If it is possible, you may also send us
  4253.     a copy of the program that caused the problems.  We realize that it is not
  4254.     practical to expect anyone to do this, but if some of you do it could save
  4255.     us a great deal of time by eliminating the need to track down the program.
  4256.     Please note that QuesTronix does not endorse copyright infringement and you
  4257.     should note a programs copyright status before sending it to us.
  4258.  
  4259.  
  4260.  
  4261.  
  4262.  
  4263.  
  4264.  
  4265.  
  4266.  
  4267.  
  4268.  
  4269.  
  4270.  
  4271.  
  4272.  
  4273.  
  4274.  
  4275.  
  4276.  
  4277.  
  4278.  
  4279.  
  4280.  
  4281.  
  4282.  
  4283.  
  4284.  
  4285.  
  4286.  
  4287.  
  4288.  
  4289.  
  4290.  
  4291.  
  4292.  
  4293.  
  4294.  
  4295.  
  4296.  
  4297.  
  4298.  
  4299.  
  4300.  
  4301.  
  4302.  
  4303.                                                                           A
  4304.  
  4305.  
  4306.  
  4307. -
  4308.  
  4309. A64 ERROR REPORT                  A64 VERSION ___________________
  4310.                               (from title screen)
  4311.  
  4312. C64 PROGRAM NAME _______________________________________ VERSION ____________
  4313.  
  4314. MANUFACTURER ________________________________________________________________
  4315.  
  4316. TYPE OF PROGRAM:   GAME ___ GRAPHICS ___ UTILITIES ___ SOUND ___ BUSINESS ___ 
  4317.  
  4318.                    EDUCATION ___ OTHER (Specify) ____________________________
  4319.  
  4320. WHAT AMIGA MODEL ARE YOU USING ______________________________________________
  4321.  
  4322. HOW IS YOUR AMIGA CONFIGURED (Ex. RAM, Special boards, hard disk) ___________
  4323.  
  4324. _____________________________________________________________________________
  4325.  
  4326.  
  4327. FILL IN THE FOLLOWING INFORMATION IF APPLICABLE (It is obtained by selecting
  4328.    DEBUG when an error requester occurs).
  4329.  
  4330. INTERNAL ERROR #: $____________
  4331.  
  4332. D0: $____________   D1: $____________   D2: $____________   D3: $____________
  4333.  
  4334. D4: $____________   D5: $____________   D6: $____________   D7: $____________
  4335.  
  4336. A0: $____________   A1: $____________   A2: $____________   A3: $____________
  4337.  
  4338. A4: $____________   A5: $____________   A6: $____________   A7: $____________
  4339.  
  4340. PC: $____________   SR: $____________
  4341.  
  4342.  
  4343. PLEASE GIVE A DISCRIPTION OF THE PROBLEM (Be as specific as possible) _______
  4344.  
  4345. _____________________________________________________________________________
  4346.  
  4347. _____________________________________________________________________________
  4348.  
  4349. _____________________________________________________________________________
  4350.  
  4351. _____________________________________________________________________________
  4352.  
  4353. _____________________________________________________________________________
  4354.  
  4355. _____________________________________________________________________________
  4356.  
  4357. _____________________________________________________________________________
  4358.  
  4359. _____________________________________________________________________________
  4360.  
  4361. _____________________________________________________________________________
  4362.  
  4363. _____________________________________________________________________________
  4364.  
  4365. _____________________________________________________________________________
  4366.  
  4367. _____________________________________________________________________________
  4368.  
  4369. _____________________________________________________________________________
  4370.  
  4371.      (Please use a separate ERROR REPORT for each C64 program).
  4372.  
  4373. -
  4374.